Variables d’environnement

Les variables d’environnement configurent votre service sans modifier le code. Chaque valeur est chiffrée au repos, masquée dans l’interface et jamais réaffichée après l’enregistrement.

Ajouter ou modifier une variable#

1. 1

   Ouvrez l’onglet Environment

   Sur la page du service, allez dans l’onglet Environment.

2. 2

   Saisissez une clé et une valeur

   Tapez le nom de la variable (mis en majuscules automatiquement, ex. NODE_ENV) et sa valeur, puis cliquez sur « Add ». Réutiliser une clé l’écrase.

3. 3

   Redéployez pour appliquer

   Les changements prennent effet au prochain déploiement — cliquez sur « Deploy » quand vous êtes prêt.

Connecter une base de données#

Ouvrez l’onglet Connect d’une base de données pour révéler un bloc de variables de connexion prêt à coller — par exemple DATABASE_URL pour Postgres/MySQL, MONGODB_URI pour MongoDB, ou REDIS_URL pour Redis. Copiez-les dans l’environnement de votre service.

Limites et règles#

• Les clés sont mises en majuscules automatiquement (node_env devient NODE_ENV).
• Les valeurs peuvent atteindre 32 768 caractères.
• Les changements prennent effet au prochain déploiement.
• L’API et la CLI ne renvoient que les clés — jamais les valeurs stockées.

Groupes d’env (config partagée)#

Créez un groupe d’env réutilisable dans Groupes d’env, ajoutez des variables (ou importez un .env), et attachez-le à plusieurs services. Au déploiement, les variables du groupe sont injectées dans chaque service attaché — les variables propres au service priment. Pratique pour les secrets et la config partagés.

Variables de build#

Les variables sont normalement injectées au démarrage du conteneur, afin qu’aucun secret ne se retrouve dans l’image. Certains builds en ont besoin plus tôt — une application Next.js qui pré-rend ses pages depuis la base de données, ou des valeurs NEXT_PUBLIC_/VITE_ intégrées au bundle navigateur. Marquez ces clés avec l’icône marteau dans l’onglet Environnement, ou ajoutez-les sous « Variables de build ».

• Seules les clés marquées sont exposées — le reste demeure exclusivement à l’exécution.
• Les valeurs sont montées comme secrets de build pour l’étape qui les lit, jamais écrites dans une couche d’image.
• Les clés se résolvent comme à l’exécution : le DATABASE_URL d’une base liée suffit à lister cette seule clé.
• Ce que votre build écrit à partir d’une valeur persiste : une valeur NEXT_PUBLIC_ intégrée reste dans le bundle, car c’est votre framework qui l’y a mise.