Les variables d’environnement configurent votre application au moment du build et de l’exécution. Elles sont gérées dans l’onglet Variables de votre projet.
Ajouter une variable
- Ouvrez le projet → onglet Variables.
- Cliquez sur Ajouter une variable (Add Variable).
- Saisissez la clé (ex :
DATABASE_URL) et la valeur. - Enregistrez.
Capture à venir
fr/variables-overview
Cette capture illustrera la vue correspondante. Elle est générée automatiquement par le pipeline Playwright.
Attention
Les variables sont injectées au build et au démarrage des conteneurs. Après une modification, redéployez pour appliquer les changements.
Variables injectées au build
Ces préfixes sont injectés pendant le build de l’image :
VITE_* Vite / frontend
NEXT_PUBLIC_* Next.js
REACT_APP_* Create React App
NUXT_* NuxtDétection des secrets
Paylood masque automatiquement les valeurs sensibles dans l’interface selon la clé :
APP_KEY,JWT_SECRET*_API_KEY,*_SECRET*_PASSWORD,*_PRIVATE_KEY
La valeur est conservée côté serveur (chiffrée) mais n’est pas ré-affichée dans l’interface.
Import depuis un fichier .env
- Dans l’onglet Variables (ou l’assistant de création), cliquez sur Importer un
.env(Import .env). - Sélectionnez votre fichier local.
- Chaque
CLÉ=valeurest parsée et ajoutée. Les doublons sont signalés.
Validation des doublons
L’interface refuse d’enregistrer deux variables avec la même clé dans un même environnement : un message d’erreur s’affiche et vous devez corriger avant de continuer.
Supprimer une variable
Ouvrez la ligne de la variable puis Supprimer (Delete). Pensez à redéployer pour retirer la variable des conteneurs en cours.
Astuce
Organisez vos secrets par environnement : une variable présente uniquement sur main n’est jamais appliquée à develop.