Première installation de test
Cette procédure installe Save2ERP sur un poste Windows, avec Docker, pour un premier test en local (https://localhost:5000). Elle prend une trentaine de minutes.
Pour un test uniquement
Le certificat créé ici n'est reconnu que par ce poste. Pour un serveur partagé, voir Installer en production.
Avant de commencer
- Docker Desktop et Node.js (pour la commande
npxde l'étape 2) installés sur le poste. - Les fichiers remis par Swiss Computing :
docker-compose.yml,license.lic,.env(ou le modèle.env.example, à compléter, voir Configurer le serveur) et le manifeste de test. - L'accès à l'image Docker : soit un jeton d'accès au registre d'images, soit le fichier de l'image (
save2erp-<version>.tar.gz).
Toutes les commandes se lancent dans PowerShell, depuis le dossier d'installation.
1. Préparer le dossier
Créez un dossier, par exemple C:\save2erp, et copiez-y docker-compose.yml, license.lic et .env. Puis :
cd C:\save2erp
dir -ForceLa commande doit lister les trois fichiers (-Force affiche aussi .env).
2. Créer le certificat HTTPS
Word n'accepte qu'une adresse HTTPS avec un certificat reconnu par Windows, même sur localhost. L'outil de Microsoft pour les compléments Office crée ce certificat et installe son autorité dans Windows :
npx office-addin-dev-certs install --days 365Si npx demande d'installer le paquet, répondez y. Windows demande ensuite d'installer l'autorité « Developer CA for Microsoft Office Add-ins » : répondez Oui.
3. Copier le certificat dans le dossier
New-Item -ItemType Directory -Force dev\certificates
Copy-Item $env:USERPROFILE\.office-addin-dev-certs\localhost.* dev\certificates\
dir dev\certificatesLe dossier dev\certificates doit contenir localhost.crt et localhost.key.
4. Déclarer le certificat dans docker-compose.yml
Ouvrez docker-compose.yml et ajoutez cette ligne dans la liste volumes: du service save2erp, avec la même indentation que les lignes voisines :
- ./dev/certificates:/app/dev/certificates:ro5. Récupérer l'image
Avec un jeton d'accès au registre :
docker login ghcr.io -u <utilisateur remis par Swiss Computing>Au message Password:, collez le jeton (rien ne s'affiche pendant la saisie), puis Entrée. Docker répond Login Succeeded.
Avec le fichier de l'image :
docker load -i save2erp-<version>.tar.gz6. Démarrer Save2ERP
docker compose up -d7. Vérifier les logs
docker compose logs -fLes logs doivent indiquer, entre autres :
Licence : …avec le nom du client, le nombre d'utilisateurs et la date de fin ;- une ligne par système déclaré dans le
.env, avec son environnement ; Certificat HTTPS : …, valable jusqu'au …;Server HTTPS started on port 5000.
Quittez l'affichage avec Ctrl+C : le conteneur continue de tourner. En cas d'erreur « Fichier du certificat HTTPS illisible », vérifiez les étapes 3 et 4, puis relancez docker compose up -d.
8. Vérifier dans le navigateur
Ouvrez dans Edge ou Chrome la page de diagnostic https://localhost:5000/test. Elle doit s'ouvrir sans avertissement de certificat. Vous pouvez y tester la connexion au système cible (voir Diagnostiquer un problème).
9. Ajouter le complément à Word
Pour un test sur un seul poste, Word peut charger le complément depuis un dossier partagé contenant le manifeste :
- Déposez le manifeste dans un dossier partagé du réseau.
- Dans Word : Fichier › Options › Centre de gestion de la confidentialité › Paramètres du Centre de gestion de la confidentialité › Catalogues de compléments approuvés.
- Saisissez le chemin réseau du dossier dans « URL du catalogue », cliquez sur Ajouter un catalogue, cochez Afficher dans le menu, puis OK.
- Redémarrez Word, puis Compléments › Plus de compléments › Dossier partagé › Save2ERP › Ajouter.
Le bouton « Sauvegarder dans SAP » apparaît dans le ruban. Pour tous les utilisateurs, déployez plutôt le complément depuis Microsoft 365 (voir Déployer dans Microsoft 365).
Commandes utiles
| Action | Commande |
|---|---|
| Démarrer | docker compose up -d |
| Arrêter | docker compose down |
| Consulter les logs | docker compose logs -f |
| Modifier la configuration | modifier .env, puis docker compose restart |
| Renouveler la licence | remplacer license.lic, puis docker compose restart |
Remettre le poste à zéro
docker compose down -v
docker rmi ghcr.io/swiss-computing/save2erp:<version>
docker logout ghcr.io
Remove-Item -Recurse -Force dev\certificates
npx office-addin-dev-certs uninstalldown -v supprime aussi les volumes : le registre des utilisateurs de la licence et les logs. La dernière commande retire l'autorité de certification du poste.