Déploiement et exploitation

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 :

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#

VariableRôleDéfautSecret
APP_URLOrigine HTTPS publique, sans chemin, par exemple https://maintenance.maintain.example. Sert aux liens envoyés et aux contrôles d'origine.RequisNon
APP_KEYClé de l'application : sessions, liens privés, file de messagerie chiffrée.RequisOui
LOG_LEVELNiveau des journaux techniques.infoNon
SOURCE_COMMITCommit déployé, inscrit dans l'image. Fourni par Coolify.unknownNon

PostgreSQL#

VariableRôleDéfautSecret
MVP_DB_NAMENom de la base.maintainNon
POSTGRES_SUPERUSER_PASSWORDSuperutilisateur postgres : initialisation, sauvegardes, exploitation. Jamais transmis à l'application.RequisOui
MVP_DB_MIGRATION_USERRôle de migration (propriétaire).maintain_ownerNon
MVP_DB_MIGRATION_PASSWORDMot de passe du rôle de migration, 24 caractères au moins.RequisOui
MVP_DB_RUNTIME_USERRôle runtime du web et du worker.maintain_runtimeNon
MVP_DB_RUNTIME_PASSWORDMot de passe du rôle runtime, 24 caractères au moins.RequisOui
MVP_DB_MAINTENANCE_ROLERôle sans connexion, réservé à la purge du journal.maintain_retentionNon

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#

VariableRôleDéfautSecret
REDIS_PASSWORDMot de passe Redis, 24 caractères au moins. Redis refuse de démarrer avec un mot de passe plus court.RequisOui

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

VariableRôleDéfautSecret
IDENTITY_ENABLEDActive les comptes et la connexion.falseNon
OTP_HMAC_KEYClé des codes de sécurité, indépendante de APP_KEY.—Oui
MAIL_TRANSPORTnone, smtp ou resend.noneNon
MAIL_FROMAdresse d'expédition simple.—Non
SMTP_HOST, SMTP_PORT, SMTP_SECUREServeur SMTP. SMTP_SECURE=true : TLS implicite ; false : STARTTLS obligatoire.—, 587, falseNon
SMTP_USER, SMTP_PASSWORDIdentifiants SMTP, à fournir ensemble.—Mot de passe : oui
RESEND_API_KEYClé du fournisseur Resend.—Oui

Détails dans Messagerie et codes de sécurité.

GitHub, modèle et publication#

VariableRôleDéfautSecret
MVP_GITHUB_APP_IDIdentifiant de la GitHub App.—Non
MVP_GITHUB_APP_PRIVATE_KEYClé privée de l'App, en variable multiligne.—Oui
MVP_GITHUB_WEBHOOK_SECRETSecret de signature du webhook.—Oui
MVP_AGENT_MODEoff ou live : active les exécutions de maintenance.offNon
MVP_LANGDOCK_API_KEYClé du fournisseur de modèles Langdock.—Oui
MVP_LANGDOCK_MODELIdentifiant du modèle utilisé.—Non
MVP_LANGDOCK_RATESTarifs contractuels en JSON, par million de jetons.[]Non
MVP_RUN_MAX_TOKENSPlafond de jetons par exécution.80000Non
MVP_PUBLICATION_NOTICES_ENABLEDActive les notifications avant publication.falseNon
MVP_NOTICE_WEBHOOK_URL, MVP_NOTICE_WEBHOOK_SECRETWebhook d'équipe approuvé (HTTPS) et son secret de 32 octets au moins.—Secret : oui
MVP_RESEND_BOUNCE_SECRETSecret de signature des retours de rebond Resend.—Oui
MVP_GITHUB_PUBLICATION_ENABLEDActive les écritures GitHub (branche, PR brouillon).falseNon
MVP_GITHUB_ANSWER_COMMANDNom de la commande de réponse sur la PR.answerNon

Activation et prérequis dans GitHub App et interrupteurs. Le format des tarifs y est aussi décrit.

API#

VariableRôleDéfautSecret
MVP_API_RATE_LIMIT_PER_MINUTEQuota par clé et par projet. Ne peut qu'abaisser le plafond de 120 requêtes par minute (1 à 120).120Non

Audits et contrôles dynamiques#

VariableRôleDéfautSecret
MVP_REPOSITORY_AUDITS_ENABLEDActive les audits de dépôt.falseNon
MVP_AUDIT_ISSUES_ENABLEDAutorise l'ouverture d'issues depuis les constats.falseNon
ACTIVE_TESTS_ENABLEDAutorise les accords de recette et les contrôles dynamiques.falseNon
MVP_SCANNER_URLAdresse du scanner, http://scanner:8080 avec le profil scanner.—Non
SCANNER_TOKENJeton du scanner, 24 caractères au moins.—Oui
SCANNER_EGRESS_TOKENJeton du proxy de sortie du scanner.—Oui
ZAP_API_KEYClé de l'outil ZAP, 16 caractères au moins.—Oui
SCANNER_EGRESS_TLS_DIRDossier de l'hôte contenant la paire TLS du proxy.—Non
MVP_SCANNER_CONCURRENCY, MVP_SCANNER_MAX_SECONDS, MVP_SCANNER_MAX_RPSConcurrence, durée maximale et débit du scanner.1, 300, 2Non

Banc d'essai#

VariableRôleDéfautSecret
MVP_BENCHMARK_MODEoff, simulated (aucun fournisseur) ou live.offNon
BENCHMARK_FIXTURES_DIRDossier de l'hôte contenant le témoin du banc, monté en lecture seule.—Non

Supervision et alertes#

VariableRôleDéfautPlage
MVP_METRICS_TOKENJeton des métriques internes, 32 caractères au moins. Vide : métriques désactivées. Secret.——
MVP_ALERT_MAIL_ENABLEDEnvoie les alertes par e-mail aux Administrateurs.false—
MVP_MONITOR_INTERVAL_SECONDSIntervalle de surveillance.6010 à 3 600
MVP_ALERT_REPEAT_MINUTESDélai minimal entre deux rappels.24015 à 10 080
MVP_ALERT_QUEUE_DELAY_SECONDSRetard à partir duquel un travail compte comme en retard.30060 à 86 400
MVP_ALERT_DISK_MIN_FREE_PERCENTEspace libre minimal du stockage privé.101 à 50
MVP_ALERT_DATABASE_MAX_BYTESTaille de référence de la base (alerte à 90 %).10 Gio1 Mio à 16 Tio
MVP_ALERT_RETENTION_DAYSConservation des alertes résolues.907 à 3 650
MVP_ALERT_PROVIDER_FAILURESÉchecs consécutifs avant alerte fournisseur.52 à 100

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

Profils ponctuels#

VariableRôleDéfaut
LEGACY_IMPORT_DIRDossier privé de l'hôte pour l'import (profil import).—
AUDIT_EXPORT_DIRDossier privé de l'hôte pour l'export du journal (profil maintenance).—
MVP_AUDIT_RETENTION_DAYSDurée de conservation du journal, 180 à 3 650 jours.180
MVP_AUDIT_RETENTION_MAX_ROWSLignes exportées au plus par passage.100000
COMPOSE_PROFILESProfils à activer, par exemple scanner,benchmark.—

Pour continuer#

Déployez l'instance avec Déployer sur Coolify.