Installation avec Docker

Vérifiez votre NAS

Le NAS doit proposer Docker/containers et Portainer CE doit être connecté à son environnement local. Vérifiez le modèle et, surtout pour un NAS ancien, relevez son noyau avec uname -r (le guide de compatibilité explique comment). Le seuil testé pour CUP est Linux 3.10.108.

NAS récent — noyau avec getrandom : l’image utilise la fonction native du noyau.
NAS ancien — noyau sans getrandom : à partir du seuil testé 3.10.108, l’image détecte cette absence et active automatiquement le repli APR prévu pour ce cas.
Sous 3.10.108 : n’installez pas CUP avant une mise à jour compatible ou une vérification du modèle. Docker doit aussi démarrer et l’architecture du processeur doit être prise en charge.

Téléchargez l’archive et préparez le stockage

Téléchargez l’archive TAR.GZ ci-dessous. Dans File Station, créez un dossier dédié aux données CUP, par exemple /volume1/docker/cup/cup_data. Ne choisissez pas le dossier d’une autre installation CUP. Relevez l’adresse IP locale du NAS et choisissez un port libre, par exemple 18080.

Construisez l’image dans Portainer

1. Ouvrez local → Images → Build a new image.
2. Nommez l’image cup-installer:nas-test et choisissez URL.
3. URL : https://cup-studio.com/downloads/CUP-Installer-Docker.tar.gz
4. Dockerfile path : docker/Dockerfile. Cliquez Build the image et attendez la confirmation Successful. Vérifiez ensuite que cup-installer:nas-test apparaît dans Images.

La construction télécharge les composants nécessaires et peut prendre plusieurs minutes. Elle se fait sur le NAS; l’archive est déjà hébergée sur CUP Studio.

Créez la pile CUP

Dans Portainer, ouvrez Stacks → Add stack, donnez un nom comme cup-nas et choisissez Web editor. Collez le Compose ci-dessous puis remplacez l’adresse IP, le port et le chemin de données par vos valeurs. Le port doit être libre et le dossier doit exister.

services:
  cup-nas:
    image: cup-installer:nas-test
    container_name: cup-nas
    restart: unless-stopped
    ports:
      - "ADRESSE_IP_DU_NAS:18080:80"
    volumes:
      - /volume1/docker/cup/cup_data:/srv/cup
    environment:
      TZ: Europe/Paris
      CUP_DATA_LABEL: /volume1/docker/cup/cup_data
      CUP_PUBLIC_URL: ""

Cliquez Deploy the stack. Dans Containers, vérifiez que cup-nas est running et que le port 18080:80 est publié. En cas de conflit de port, supprimez la pile, choisissez un autre port libre et redéployez.

Ouvrez l’installateur et terminez

Depuis un appareil du même réseau, ouvrez http://ADRESSE_IP_DU_NAS:18080 (avec le port que vous avez choisi). Créez l’accès propriétaire, saisissez l’adresse e-mail et le code associés à votre licence CUP, puis attendez la fin du téléchargement et de la vérification. Quand l’écran indique que CUP est prêt, cliquez Entrer dans CUP et connectez-vous avec l’identifiant créé.

L’adresse locale et HTTP servent au premier accès sur votre réseau. Pour donner accès depuis Internet, configurez d’abord un nom de domaine, HTTPS et le proxy inverse du NAS. Ne redirigez pas directement le port du conteneur vers Internet.

Configurez votre espace CUP

1. Dans Gestion → Préférences, vérifiez le profil Production : prénom affiché, nom, e-mail et téléphone.
2. Personnalisez l’identité CUP si vous le souhaitez : nom affiché, logo et couleurs. Ces réglages pourront être modifiés plus tard.
3. Avant d’envoyer des invitations, configurez le serveur SMTP dans Préférences → Installation & santé et envoyez un e-mail de test. Si vous n’avez pas les paramètres de votre fournisseur, demandez-les à votre hébergeur ou à votre administrateur e-mail.
4. Activez la double vérification si elle est proposée pour votre compte, puis enregistrez vos préférences.

Faites vos premiers pas

1. Depuis l’espace Production, choisissez Clients puis créez votre premier client avec son nom et ses coordonnées.
2. Ouvrez sa fiche et créez un projet. Donnez-lui un nom, choisissez les étapes du pipeline et ajoutez un bref descriptif si utile.
3. Importez quelques images dans une série ou une galerie pour vérifier le stockage et les aperçus. Commencez par un petit lot de fichiers.
4. Quand l’e-mail de test fonctionne, invitez votre adresse secondaire ou un client de confiance dans le projet, puis vérifiez le parcours depuis une fenêtre privée.

Les dossiers CUP et les projets restent stockés dans le dossier de données que vous avez lié au conteneur. Incluez ce dossier dans vos sauvegardes régulières du NAS.

Activer FTP/FTPS sur un Synology (facultatif)

Dans DSM, ouvrez Panneau de configuration → Services de fichiers → FTP. Cochez Activer le service FTP et Activer le service de chiffrement FTP SSL/TLS (FTPS). Le port de contrôle est généralement TCP 21. Dans Plage de ports FTP passif, gardez la plage affichée (par défaut 55536–55899) ou définissez une plage fixe, puis utilisez exactement cette même plage dans les règles du pare-feu du NAS et du routeur si l’accès vient d’Internet. Pour SFTP, descendez à la section SFTP sur cette même page et activez le service : il utilise TCP 22, ce n’est pas FTP/FTPS.

Pour un essai sur le réseau local, aucune redirection de port sur le routeur n’est nécessaire. Évitez FTP sans chiffrement sur Internet. Le dossier servi par le NAS doit aussi être accessible à CUP dans le conteneur et choisi comme dossier d’arrivée; activer FTP seul ne le relie pas automatiquement à CUP.