Ajouter Stackmill à un serveur existant¶

Pour un serveur Linux que le client administre lui-même. Si la machine est dédiée à Stackmill, l'installation du serveur est plus simple et s'occupe aussi du système.

Ce qu'il faut¶

Ubuntu 22.04, Ubuntu 24.04 ou Debian 12 en x86-64, avec un accès root.
Un TPM 2.0 (/dev/tpmrm0). Sans lui, la licence exige un internet permanent et la machine ne peut que simuler, jamais piloter un vrai robot.
Une machine physique. Une machine virtuelle est refusée : sa puce de sécurité se copie avec elle.
Internet pendant l'installation.
L'identifiant d'organisation et le jeton de registre, sur la page Serveur du portail.

Installer¶

Le portail affiche la commande, déjà remplie pour l'organisation :

curl -fsSL https://dist.apemill.com/install.sh | sudo bash -s -- --org <id> --token <jeton>

Pour la lire d'abord, téléchargez install.sh et son empreinte depuis la même page, vérifiez-la, puis exécutez le script avec les mêmes options.

Il installe Docker si la machine n'en a pas, télécharge l'image Stackmill, vérifie la signature d'Apemill dessus et démarre le service. L'exécuter deux fois ne change rien et ne touche jamais aux données.

Options utiles :

Option	Pour
`--http-port 8080`	quand quelque chose répond déjà sur le port 80
`--data-dir /srv/stackmill`	placer les données sur un autre disque
`--bundle stackmill-server-<version>.tar`	une machine sans internet : téléchargez l'archive depuis le portail et copiez-la
`--version 1.4.0`	une version précise plutôt que la plus récente
`--uninstall`	retirer Stackmill en conservant les données

Activer¶

Ouvrez http://<adresse du serveur>, collez la clé de licence serveur dans le panneau de licence et validez. L'activation enregistre aussi l'identifiant dont la machine a besoin pour ses mises à jour : plus rien à saisir ensuite.

Exploiter¶

stackmillctl status     # version, licence, cellule en marche ou non
stackmillctl check      # existe-t-il une version plus récente
sudo stackmillctl update    # l'installer : refuse si une cellule tourne, revient en arrière en cas d'échec
sudo stackmillctl rollback  # revenir à la version précédente
stackmillctl logs
sudo stackmillctl backup    # archiver le dossier de données

L'interface propose aussi un bouton Mettre à jour, qui exécute exactement la même chose.

Sans l'installateur¶

Stackmill fonctionne avec un simple docker compose sur n'importe quel hôte Docker : connectez- vous à docker.apemill.com avec l'identifiant d'organisation et le jeton, fixez une version dans le fichier compose, démarrez. Il n'y a alors ni stackmillctl, ni bouton Mettre à jour, ni assistance à distance — la fenêtre de mise à jour affiche les deux commandes à lancer. Demandez le fichier compose à Apemill.

Ce qu'il faut sauvegarder¶

Uniquement le dossier de données, /opt/stackmill/data par défaut. Il contient les projets, la licence et les réglages ; tout le reste se réinstalle depuis le portail en quelques minutes.

Le restaurer sur une machine sans TPM impose de réactiver la licence : le serveur de licences ne peut pas distinguer une restauration d'une machine dupliquée. Avec un TPM, la restauration fonctionne telle quelle.