---
title: Installer une instance de zéro
description: Scénario complet, d'un serveur Coolify vide au premier Administrateur connecté, avec /readyz au vert.
---

# 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.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
```

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

3. **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.

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

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

6. **Contrôler la santé.**

```bash
curl -sS https://maintenance.maintain.example/healthz
curl -sS https://maintenance.maintain.example/readyz
```

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

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

9. **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.

10. **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ôme | Voir |
| --- | --- |
| `release_failed` ou variable « requis » | [Déployer sur Coolify](../08-deploiement-et-exploitation/03-deployer-sur-coolify.md) |
| `/readyz` en 503 avec `identity` | [Messagerie et codes de sécurité](../08-deploiement-et-exploitation/05-messagerie-et-codes.md) |
| Le bootstrap est refusé | [Premier administrateur et récupération](../08-deploiement-et-exploitation/04-premier-administrateur-et-recuperation.md) |
| Camille ne reçoit pas de code | [Santé, métriques et alertes](../08-deploiement-et-exploitation/07-sante-metriques-et-alertes.md) |

## Pour continuer

Camille peut maintenant [embarquer une équipe sur un projet](02-embarquer-une-equipe-sur-un-projet.md).
