---
title: Variables d'environnement
description: Toutes les variables du Compose de l'instance, regroupées par famille, avec leur rôle, leur valeur par défaut et leur caractère secret.
---

# Variables d'environnement

L'instance se configure uniquement par variables d'environnement. Cette page les regroupe par famille. Les noms sont ceux de `compose.mvp.yaml`, qui fait foi.

**Qui peut le faire :** l'exploitant. Sur Coolify, les variables se saisissent dans l'onglet *Environment Variables* de la ressource.

> [!WARNING]
> Ne publiez jamais une valeur secrète : ni dans un dépôt, ni dans un ticket, ni dans une capture. Cochez *Is Secret* dans Coolify et conservez chaque secret dans le coffre de l'équipe : sans eux, une sauvegarde est inutilisable.

Générez chaque secret séparément, par exemple :

```bash
openssl rand -hex 32
```

Pour `APP_KEY`, utilisez 32 octets encodés en base64 :

```bash
node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
```

Dans les tableaux, « Requis » signifie que le Compose refuse de démarrer sans la variable. « — » signifie vide par défaut.

## Application

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `APP_URL` | Origine HTTPS publique, sans chemin, par exemple `https://maintenance.maintain.example`. Sert aux liens envoyés et aux contrôles d'origine. | Requis | Non |
| `APP_KEY` | Clé de l'application : sessions, liens privés, file de messagerie chiffrée. | Requis | Oui |
| `LOG_LEVEL` | Niveau des journaux techniques. | `info` | Non |
| `SOURCE_COMMIT` | Commit déployé, inscrit dans l'image. Fourni par Coolify. | `unknown` | Non |

> [!NOTE]
> Changer `APP_KEY` invalide toutes les sessions et tous les liens, et rend illisibles les messages en attente. Ce n'est pas une variable cosmétique.

## PostgreSQL

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `MVP_DB_NAME` | Nom de la base. | `maintain` | Non |
| `POSTGRES_SUPERUSER_PASSWORD` | Superutilisateur `postgres` : initialisation, sauvegardes, exploitation. Jamais transmis à l'application. | Requis | Oui |
| `MVP_DB_MIGRATION_USER` | Rôle de migration (propriétaire). | `maintain_owner` | Non |
| `MVP_DB_MIGRATION_PASSWORD` | Mot de passe du rôle de migration, 24 caractères au moins. | Requis | Oui |
| `MVP_DB_RUNTIME_USER` | Rôle runtime du web et du worker. | `maintain_runtime` | Non |
| `MVP_DB_RUNTIME_PASSWORD` | Mot de passe du rôle runtime, 24 caractères au moins. | Requis | Oui |
| `MVP_DB_MAINTENANCE_ROLE` | Rôle sans connexion, réservé à la purge du journal. | `maintain_retention` | Non |

Les rôles et leurs mots de passe sont créés une seule fois, à l'initialisation d'un volume vide. Voir [Rétention du journal et rôles PostgreSQL](10-retention-et-roles-postgresql.md).

## Redis

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `REDIS_PASSWORD` | Mot de passe Redis, 24 caractères au moins. Redis refuse de démarrer avec un mot de passe plus court. | Requis | Oui |

## Identité, codes de sécurité et messagerie

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `IDENTITY_ENABLED` | Active les comptes et la connexion. | `false` | Non |
| `OTP_HMAC_KEY` | Clé des codes de sécurité, indépendante de `APP_KEY`. | — | Oui |
| `MAIL_TRANSPORT` | `none`, `smtp` ou `resend`. | `none` | Non |
| `MAIL_FROM` | Adresse d'expédition simple. | — | Non |
| `SMTP_HOST`, `SMTP_PORT`, `SMTP_SECURE` | Serveur SMTP. `SMTP_SECURE=true` : TLS implicite ; `false` : STARTTLS obligatoire. | —, `587`, `false` | Non |
| `SMTP_USER`, `SMTP_PASSWORD` | Identifiants SMTP, à fournir ensemble. | — | Mot de passe : oui |
| `RESEND_API_KEY` | Clé du fournisseur Resend. | — | Oui |

Détails dans [Messagerie et codes de sécurité](05-messagerie-et-codes.md).

## GitHub, modèle et publication

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `MVP_GITHUB_APP_ID` | Identifiant de la GitHub App. | — | Non |
| `MVP_GITHUB_APP_PRIVATE_KEY` | Clé privée de l'App, en variable multiligne. | — | Oui |
| `MVP_GITHUB_WEBHOOK_SECRET` | Secret de signature du webhook. | — | Oui |
| `MVP_AGENT_MODE` | `off` ou `live` : active les exécutions de maintenance. | `off` | Non |
| `MVP_LANGDOCK_API_KEY` | Clé du fournisseur de modèles Langdock. | — | Oui |
| `MVP_LANGDOCK_MODEL` | Identifiant du modèle utilisé. | — | Non |
| `MVP_LANGDOCK_RATES` | Tarifs contractuels en JSON, par million de jetons. | `[]` | Non |
| `MVP_RUN_MAX_TOKENS` | Plafond de jetons par exécution. | `80000` | Non |
| `MVP_PUBLICATION_NOTICES_ENABLED` | Active les notifications avant publication. | `false` | Non |
| `MVP_NOTICE_WEBHOOK_URL`, `MVP_NOTICE_WEBHOOK_SECRET` | Webhook d'équipe approuvé (HTTPS) et son secret de 32 octets au moins. | — | Secret : oui |
| `MVP_RESEND_BOUNCE_SECRET` | Secret de signature des retours de rebond Resend. | — | Oui |
| `MVP_GITHUB_PUBLICATION_ENABLED` | Active les écritures GitHub (branche, PR brouillon). | `false` | Non |
| `MVP_GITHUB_ANSWER_COMMAND` | Nom de la commande de réponse sur la PR. | `answer` | Non |

Activation et prérequis dans [GitHub App et interrupteurs](06-github-app-et-fonctionnalites.md). Le format des tarifs y est aussi décrit.

## API

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `MVP_API_RATE_LIMIT_PER_MINUTE` | Quota par clé et par projet. Ne peut qu'abaisser le plafond de 120 requêtes par minute (1 à 120). | `120` | Non |

## Audits et contrôles dynamiques

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `MVP_REPOSITORY_AUDITS_ENABLED` | Active les audits de dépôt. | `false` | Non |
| `MVP_AUDIT_ISSUES_ENABLED` | Autorise l'ouverture d'issues depuis les constats. | `false` | Non |
| `ACTIVE_TESTS_ENABLED` | Autorise les accords de recette et les contrôles dynamiques. | `false` | Non |
| `MVP_SCANNER_URL` | Adresse du scanner, `http://scanner:8080` avec le profil `scanner`. | — | Non |
| `SCANNER_TOKEN` | Jeton du scanner, 24 caractères au moins. | — | Oui |
| `SCANNER_EGRESS_TOKEN` | Jeton du proxy de sortie du scanner. | — | Oui |
| `ZAP_API_KEY` | Clé de l'outil ZAP, 16 caractères au moins. | — | Oui |
| `SCANNER_EGRESS_TLS_DIR` | Dossier de l'hôte contenant la paire TLS du proxy. | — | Non |
| `MVP_SCANNER_CONCURRENCY`, `MVP_SCANNER_MAX_SECONDS`, `MVP_SCANNER_MAX_RPS` | Concurrence, durée maximale et débit du scanner. | `1`, `300`, `2` | Non |

## Banc d'essai

| Variable | Rôle | Défaut | Secret |
| --- | --- | --- | --- |
| `MVP_BENCHMARK_MODE` | `off`, `simulated` (aucun fournisseur) ou `live`. | `off` | Non |
| `BENCHMARK_FIXTURES_DIR` | Dossier de l'hôte contenant le témoin du banc, monté en lecture seule. | — | Non |

## Supervision et alertes

| Variable | Rôle | Défaut | Plage |
| --- | --- | --- | --- |
| `MVP_METRICS_TOKEN` | Jeton des métriques internes, 32 caractères au moins. Vide : métriques désactivées. **Secret.** | — | — |
| `MVP_ALERT_MAIL_ENABLED` | Envoie les alertes par e-mail aux Administrateurs. | `false` | — |
| `MVP_MONITOR_INTERVAL_SECONDS` | Intervalle de surveillance. | `60` | 10 à 3 600 |
| `MVP_ALERT_REPEAT_MINUTES` | Délai minimal entre deux rappels. | `240` | 15 à 10 080 |
| `MVP_ALERT_QUEUE_DELAY_SECONDS` | Retard à partir duquel un travail compte comme en retard. | `300` | 60 à 86 400 |
| `MVP_ALERT_DISK_MIN_FREE_PERCENT` | Espace libre minimal du stockage privé. | `10` | 1 à 50 |
| `MVP_ALERT_DATABASE_MAX_BYTES` | Taille de référence de la base (alerte à 90 %). | 10 Gio | 1 Mio à 16 Tio |
| `MVP_ALERT_RETENTION_DAYS` | Conservation des alertes résolues. | `90` | 7 à 3 650 |
| `MVP_ALERT_PROVIDER_FAILURES` | Échecs consécutifs avant alerte fournisseur. | `5` | 2 à 100 |

Une valeur hors plage est ramenée à la borne la plus proche.

## Profils ponctuels

| Variable | Rôle | Défaut |
| --- | --- | --- |
| `LEGACY_IMPORT_DIR` | Dossier privé de l'hôte pour l'import (profil `import`). | — |
| `AUDIT_EXPORT_DIR` | Dossier privé de l'hôte pour l'export du journal (profil `maintenance`). | — |
| `MVP_AUDIT_RETENTION_DAYS` | Durée de conservation du journal, 180 à 3 650 jours. | `180` |
| `MVP_AUDIT_RETENTION_MAX_ROWS` | Lignes exportées au plus par passage. | `100000` |
| `COMPOSE_PROFILES` | Profils à activer, par exemple `scanner,benchmark`. | — |

## Pour continuer

Déployez l'instance avec [Déployer sur Coolify](03-deployer-sur-coolify.md).
