Installer une instance de zéro
Ce scénario suit l'exploitant de l'entreprise fictive Atelier Exemple qui installe 101Maintain sur maintenance.maintain.example.
Objectif#
Disposer d'une instance déployée, saine, avec un premier Administrateur capable de se connecter.
Rôles nécessaires#
| Rôle | Personne | Intervient pour |
|---|---|---|
| Exploitant | Sam | Coolify, variables, commandes serveur |
| Futur Administrateur | Camille | Première connexion |
Prérequis#
- Un serveur Coolify relié au dépôt source de 101Maintain.
- Le domaine
maintenance.maintain.examplepointé vers ce serveur. - Un compte SMTP ou Resend avec une adresse d'expédition validée.
- Le coffre de l'équipe pour ranger les secrets.
Étapes#
- Générer les secrets. Sam génère six valeurs distinctes et les range aussitôt dans le coffre :
openssl rand -hex 32 # POSTGRES_SUPERUSER_PASSWORD
openssl rand -hex 32 # MVP_DB_MIGRATION_PASSWORD
openssl rand -hex 32 # MVP_DB_RUNTIME_PASSWORD
openssl rand -hex 32 # REDIS_PASSWORD
openssl rand -hex 32 # OTP_HMAC_KEY
node -e "console.log(require('crypto').randomBytes(32).toString('base64'))" # APP_KEYCréer la ressource. Dans Coolify : New Resource, dépôt source, branche
main, build pack Docker Compose, Base Directory/, Docker Compose Location/compose.mvp.yaml. Il active Include Source Commit in Build.Saisir les variables. Dans Environment Variables, il saisit au minimum (valeurs fictives, secrets cochés Is Secret) :
APP_URL=https://maintenance.maintain.example
APP_KEY=<secret>
POSTGRES_SUPERUSER_PASSWORD=<secret>
MVP_DB_MIGRATION_PASSWORD=<secret>
MVP_DB_RUNTIME_PASSWORD=<secret>
REDIS_PASSWORD=<secret>
IDENTITY_ENABLED=true
OTP_HMAC_KEY=<secret>
MAIL_TRANSPORT=smtp
MAIL_FROM=maintenance@maintain.example
SMTP_HOST=smtp.maintain.example
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<identifiant>
SMTP_PASSWORD=<secret>Les fonctions GitHub, IA et audits restent désactivées pour l'instant : leurs interrupteurs valent false ou off par défaut.
Associer le domaine. Il associe le service
web, et lui seul, àhttps://maintenance.maintain.example:3333.Déployer. Il clique sur Deploy et suit les journaux jusqu'à
release_completed, puiswebetworkerhealthy. Le servicereleasereste Exited (0).Contrôler la santé.
curl -sS https://maintenance.maintain.example/healthz
curl -sS https://maintenance.maintain.example/readyz- Créer le premier administrateur.
docker exec -it <conteneur-web> node apps/platform/build/ace.js identity:bootstrapIl répond : adresse camille@maintain.example, nom Camille Exemple, organisation Atelier Exemple. La commande affiche le chemin du fichier d'invitation.
Remettre l'invitation. Il lit le fichier avec
docker exec <conteneur-web> cat <chemin-affiché>et transmet le lien à Camille par un canal privé.Première connexion. Camille ouvre le lien, choisit son mot de passe, puis se connecte avec le code de sécurité reçu par e-mail. La barre du compte affiche Utilisateurs : elle est Administrateur.
Nettoyer et sécuriser. Après la connexion de Camille, Sam supprime le fichier d'invitation, active Auto Deploy, puis planifie la sauvegarde quotidienne :
sh infra/compose/backup.sh <projet-compose> /sauvegardes/2026-11-20Résultat attendu#
/healthzrépond{"ok":true}./readyzrépond 200 avec"unavailable": [].- La ligne
release_completedaffiche le bon commit etruntimePrivileges: "verified". - Camille est connectée et voit Projets, Supervision, Sécurité, Sessions et Utilisateurs.
- La page Exploitation n'affiche aucune alerte ouverte.
Si ça bloque#
| Symptôme | Voir |
|---|---|
release_failed ou variable « requis » | Déployer sur Coolify |
/readyz en 503 avec identity | Messagerie et codes de sécurité |
| Le bootstrap est refusé | Premier administrateur et récupération |
| Camille ne reçoit pas de code | Santé, métriques et alertes |
Pour continuer#
Camille peut maintenant embarquer une équipe sur un projet.