Exemples de mise en place

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ôlePersonneIntervient pour
ExploitantSamCoolify, variables, commandes serveur
Futur AdministrateurCamillePremière connexion

Prérequis#

  • Un serveur Coolify relié au dépôt source de 101Maintain.
  • Le domaine maintenance.maintain.example pointé 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#

  1. Générer les secrets. Sam génère six valeurs distinctes et les range aussitôt dans le coffre :
bash
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_KEY
  1. Cré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.

  2. Saisir les variables. Dans Environment Variables, il saisit au minimum (valeurs fictives, secrets cochés Is Secret) :

bash
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.

  1. Associer le domaine. Il associe le service web, et lui seul, à https://maintenance.maintain.example:3333.

  2. Déployer. Il clique sur Deploy et suit les journaux jusqu'à release_completed, puis web et worker healthy. Le service release reste Exited (0).

  3. Contrôler la santé.

bash
curl -sS https://maintenance.maintain.example/healthz
curl -sS https://maintenance.maintain.example/readyz
  1. Créer le premier administrateur.
bash
docker exec -it <conteneur-web> node apps/platform/build/ace.js identity:bootstrap

Il répond : adresse camille@maintain.example, nom Camille Exemple, organisation Atelier Exemple. La commande affiche le chemin du fichier d'invitation.

  1. Remettre l'invitation. Il lit le fichier avec docker exec <conteneur-web> cat <chemin-affiché> et transmet le lien à Camille par un canal privé.

  2. 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.

  3. Nettoyer et sécuriser. Après la connexion de Camille, Sam supprime le fichier d'invitation, active Auto Deploy, puis planifie la sauvegarde quotidienne :

bash
sh infra/compose/backup.sh <projet-compose> /sauvegardes/2026-11-20

Résultat attendu#

  • /healthz répond {"ok":true}.
  • /readyz répond 200 avec "unavailable": [].
  • La ligne release_completed affiche le bon commit et runtimePrivileges: "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ômeVoir
release_failed ou variable « requis »Déployer sur Coolify
/readyz en 503 avec identityMessagerie et codes de sécurité
Le bootstrap est refuséPremier administrateur et récupération
Camille ne reçoit pas de codeSanté, métriques et alertes

Pour continuer#

Camille peut maintenant embarquer une équipe sur un projet.