Aller au contenu

Installer avec Docker ​

L'image Docker de Save2ERP est la même pour tous les clients : elle contient l'application et ses dépendances, sans configuration, sans licence et sans données. Vous fournissez vos propres fichiers au démarrage du conteneur.

Installer ​

  1. Récupérez l'image, avec le jeton d'accès au registre (docker login ghcr.io) ou à partir du fichier remis par Swiss Computing (docker load -i save2erp-<version>.tar.gz).

  2. Préparez un dossier sur le serveur, par exemple /opt/save2erp/ :

    /opt/save2erp/
    ├── docker-compose.yml   fourni par Swiss Computing
    ├── .env                 votre configuration (modèle : .env.example), avec NODE_ENV=production
    └── license.lic          la licence remise par Swiss Computing
  3. Limitez les droits du .env, qui contient des secrets : par exemple chmod 600 .env.

  4. Démarrez :

    bash
    docker compose up -d
    docker compose logs -f

Fichiers et volumes ​

Dans le conteneurOrigineRôle
/app/.envvotre fichier .env, en lecture seuleConfiguration.
/app/license.licvotre fichier license.lic, en lecture seuleLicence.
/app/datavolume save2erp-dataRegistre des utilisateurs de la licence : à conserver.
/app/logsvolume save2erp-logsLogs de l'application.
/app/translationsfacultatif, dossier ./translationsTextes personnalisés (voir Personnaliser les textes du panneau).

Le .env est monté comme un fichier. Ne le passez pas avec env_file ou docker run --env-file : ces options ne retirent pas les commentaires en fin de ligne (SERVER_PORT=5000 # … deviendrait un port invalide).

HTTPS ​

Word exige un certificat valide. Deux possibilités :

  • Derrière le proxy HTTPS de l'entreprise (nginx, Traefik, IIS…), le plus simple : voir Derrière un proxy HTTPS. Si le proxy tourne sur le même serveur, publiez le port uniquement en local, avec "127.0.0.1:5000:5000" dans docker-compose.yml : Docker ouvre les ports publiés même si le pare-feu du serveur les bloque.
  • Le serveur gère lui-même le HTTPS : montez la clé et le certificat dans le conteneur, et indiquez leurs chemins dans TLS_KEY_FILE et TLS_CERT_FILE.

Autorité de certification de l'entreprise ​

Si le système cible utilise un certificat émis par une autorité interne, montez le certificat de cette autorité (format PEM) dans le conteneur et indiquez son chemin dans la variable NODE_EXTRA_CA_CERTS, par exemple dans la section environment: de docker-compose.yml.

Fuseau horaire ​

L'heure des logs suit la variable TZ de docker-compose.yml (Europe/Zurich dans le fichier fourni). Sans elle, l'heure est en UTC.

Commandes ​

ActionCommande
Démarrerdocker compose up -d
Renouveler la licenceremplacer license.lic, puis docker compose restart
Modifier la configurationmodifier .env, puis docker compose restart
Mettre à jour Save2ERPchanger la version de l'image dans docker-compose.yml, puis docker compose up -d
Consulter les logsdocker compose logs -f, ou docker compose exec save2erp tail -f logs/all.log

Une seule instance de Save2ERP doit tourner par client : le registre des utilisateurs est un fichier local.