Installation sur PC

Installer Docker Desktop

Téléchargez Docker Desktop pour Windows AMD64. Gardez l’installation par utilisateur recommandée, choisissez WSL 2, laissez Windows Containers désactivé, puis démarrez Docker Desktop et attendez l’état Engine running.

Activer WSL 2 si nécessaire

Ouvrez Terminal en administrateur depuis le menu Démarrer. Si Docker indique que Virtual Machine Platform manque, exécutez la première commande et redémarrez si demandé. Si WSL manque encore, lancez la seconde commande.

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
# Redémarrez Windows si demandé, puis relancez Docker Desktop.
wsl --install

Télécharger et extraire CUP V7.33

Téléchargez CUP-Installer-Docker-V7.33.zip et décompressez-le dans Téléchargements. Dans l’Explorateur, ouvrez le dossier docker à l’intérieur du dossier extrait; il contient le Dockerfile, le fichier Compose et le lanceur. Gardez son chemin pour les étapes suivantes.

Set-Location "$env:USERPROFILE\Downloads\CUP-Installer-Docker-V7.33\docker"

Choisir le disque de stockage Docker

Dans Docker Desktop, ouvrez Settings → Resources → Advanced → Disk image location. Choisissez un dossier sur le disque souhaité, appliquez le réglage, confirmez le déplacement et attendez Engine running. Ce réglage déplace ensemble images, conteneurs et volumes Docker.

Vérifier que Docker peut construire l’image CUP

Vérifiez d’abord que Docker Desktop indique Engine running. Dans l’Explorateur de fichiers, ouvrez le dossier docker (celui qui contient Dockerfile), cliquez dans la barre d’adresse en haut, tapez powershell et appuyez sur Entrée. Une fenêtre PowerShell s’ouvre dans ce dossier. Cliquez sur Copier ci-dessous, cliquez dans la fenêtre, collez la commande et appuyez sur Entrée. Des lignes vont défiler pendant le téléchargement et la construction de l’image; attendez le message FINISHED ou de réussite et le retour de l’invite PowerShell. Ce test ne démarre pas CUP. Si une erreur rouge apparaît, arrêtez-vous et gardez le premier message d’erreur.

docker build --tag cup-installer:pc --file Dockerfile .

Installer le serveur OpenSSH de Windows

Ouvrez Paramètres Windows → Système → Fonctionnalités facultatives → Afficher les fonctionnalités. Recherchez OpenSSH Server, sélectionnez Serveur OpenSSH (et non Client OpenSSH), puis installez-le. Attendez que l’état indique Ajouté.

Démarrer le service SSH automatiquement

Ouvrez Services en recherchant services ou avec services.msc. Ouvrez les propriétés de OpenSSH SSH Server, réglez Type de démarrage sur Automatique, cliquez sur Appliquer, puis sur Démarrer. Vérifiez que l’état du service est En cours d’exécution.

Vérifier la règle du pare-feu Windows

Ouvrez Pare-feu Windows Defender avec fonctions avancées de sécurité → Règles de trafic entrant. Vérifiez que OpenSSH SSH Server (sshd) est activée, autorise la connexion, utilise TCP sur le port local 22 et s’applique au profil Privé. Si elle manque, créez une règle entrante TCP 22 pour les réseaux privés seulement. Cela autorise l’accès sur votre réseau local de confiance; l’accès depuis Internet nécessite une configuration réseau sécurisée distincte.

Installer FileZilla Server (option FTP/FTPS)

Si vous choisissez FileZilla Server, passez les trois étapes OpenSSH ci-dessus : elles servent au SFTP. Téléchargez FileZilla Server (et non FileZilla Client) depuis le site officiel et installez-le comme service Windows. Il est gratuit et prend en charge FTP et FTPS explicite. Laissez le service démarrer avec Windows.

Créer un compte FileZilla et partager le dossier d’arrivée

Dans la fenêtre d’administration FileZilla Server, ouvrez Rights management → Users et ajoutez un compte dédié avec un mot de passe fort. Dans Mount points, reliez le vrai dossier Windows, par exemple D:\CUP-Import, au chemin virtuel /. Autorisez seulement l’affichage des dossiers et l’envoi/la création de fichiers; ne permettez pas l’accès anonyme. Le compte Windows qui exécute le service FileZilla doit pouvoir lire et écrire dans ce dossier.

Exiger FTPS et définir les ports passifs

Ouvrez Protocol settings → FTP and FTP over TLS (FTPS). Gardez l’écoute TCP sur le port 21 et exigez Explicit FTP over TLS. Dans Connection Security, gardez le certificat créé pour les essais ou installez un certificat de confiance pour un usage régulier. Dans Passive mode, définissez une plage fixe, par exemple TCP 50000–50010. Le FTP simple n’est pas chiffré; activez-le seulement si un appareil du réseau local de confiance ne sait pas utiliser FTPS. Appliquez les réglages.

Autoriser et tester FileZilla sur le réseau local

Dans le Pare-feu Windows Defender, autorisez TCP 21 et TCP 50000–50010 en entrée pour le profil Privé uniquement. Depuis un autre appareil du même réseau, ouvrez FileZilla Client : saisissez l’adresse IP locale du PC, le port 21, le compte créé, choisissez FTP explicite sur TLS et utilisez le mode passif. Envoyez une image test. Si le point de montage FileZilla expose le dossier d’arrivée comme racine, son chemin distant est /.

Choisir et tester le dossier d’arrivée

Choisissez un dossier dédié, par exemple D:\CUP-Import, sur le disque souhaité. Donnez les droits de lecture/écriture au compte qui exécute le serveur choisi. Depuis un autre appareil du même réseau, testez soit SFTP vers l’adresse IP locale du PC en TCP 22 (OpenSSH), soit FTPS explicite en TCP 21 (FileZilla Server) avec sa plage passive. Envoyez une image test et notez le chemin distant affiché par le client. Avec FileZilla, si le dossier est monté comme racine, le chemin distant est /; avec SFTP, il peut différer du chemin Windows. Utilisez ce chemin testé dans CUP.

Démarrer CUP et relier le dossier d’arrivée

Revenez dans la même fenêtre PowerShell, toujours ouverte dans le dossier docker. Pour lancer l’installation, cliquez sur Copier sous la dernière commande, collez-la dans PowerShell puis appuyez sur Entrée. Ensuite, le script pose une question à la fois : tapez une réponse puis appuyez sur Entrée avant la suivante.

• Port local de CUP :Saisissez 8080, la valeur proposée par l’installateur, ou choisissez un port local libre. C’est le port web de CUP; il est distinct des ports de transfert 21 et 22.
• Dossier partagé :Saisissez le chemin Windows exact du dossier choisi et testé, par exemple D:\CUP-Import. Le compte FileZilla ou SFTP doit pouvoir y écrire.
• Serveur FTP/SFTP existant :Saisissez l’adresse IP locale ou le nom du PC pour les transferts sur votre réseau. Si le serveur n’est pas prêt, laissez vide et complétez plus tard docker/.env.
• Protocole :Choisissez ftps pour FileZilla avec TLS, sftp pour OpenSSH, ou ftp seulement sur un réseau local de confiance. FTP transmet identifiants et fichiers sans chiffrement.
• Port du serveur :Saisissez 21 pour FTP/FTPS FileZilla ou 22 pour SFTP OpenSSH. Ce port est distinct du port web CUP.
• Chemin visible dans le client :Saisissez le chemin distant exact du test. Avec FileZilla, mettez / si le dossier d’arrivée est la racine du compte. Avec SFTP, utilisez le chemin affiché par le client; il peut différer de D:\CUP-Import.

Seulement si PowerShell indique que les scripts sont désactivés : lancez d’abord cette autorisation temporaire dans la fenêtre actuelle. Appuyez sur Entrée et confirmez si demandé.

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

.\start-cup.ps1

Le lanceur n’installe ni ne démarre OpenSSH ou FileZilla Server, ne crée aucun compte de transfert, ne règle pas le pare-feu et n’ouvre pas de port sur le routeur. Il monte le dossier d’arrivée séparément dans Docker; les données de CUP restent dans son volume Docker.

Vérifier que CUP fonctionne

Attendez la fin de la construction Compose. Dans Docker Desktop, vérifiez que le conteneur cup est actif et que le port local choisi (8080 par défaut) est relié au port 80 du conteneur. Le dossier d’arrivée est monté séparément sous /srv/cup-import. Pour le test, l’écoute reste sur 127.0.0.1 : CUP est accessible depuis ce PC seulement.

Ouvrir CUP et activer la licence

Ouvrez http://localhost:8080/ dans votre navigateur, ou utilisez le port que vous avez choisi. Saisissez le nom propriétaire, l’e-mail associé à une licence CUP valide, un identifiant, un mot de passe et le code de licence. Entrez ces informations uniquement dans l’installateur. Si la licence est refusée, vérifiez l’e-mail et le code. Arrêtez-vous ici si vous ne disposez pas d’une licence valide.

Vérifier que CUP est prêt

Après validation, CUP Central télécharge la version autorisée par la licence. Continuez jusqu’à l’écran confirmant que CUP est prêt et que la vérification du paquet est terminée. Le numéro de version de la capture peut évoluer.