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.
Générez chaque secret séparément, par exemple :
openssl rand -hex 32Pour APP_KEY, utilisez 32 octets encodés en base64 :
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 |
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.
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é.
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. 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.