Variables d'environnement

Beaucoup d’applications se configurent par des variables d’environnement (serveur d’envoi d’e-mails, langue, options…). La documentation de l’application indique lesquelles elle reconnaît.

Ajouter ou modifier des variables

Dans la console de l’application, ouvrez Variables d’env. La vue Variables d’environnement affiche vos variables personnalisées (ou « Aucune variable personnalisée »).
Cliquez sur Ajouter. Une ligne apparaît.
Remplissez Nom (par exemple MA_VARIABLE) et Valeur.
Répétez pour chaque variable. L’icône Supprimer retire une ligne.
Cliquez sur Enregistrer & redémarrer. Le message « Variables enregistrées — l’application redémarre » s’affiche.

Exemple de saisie :

SMTP_HOST=smtp.example.net
SMTP_PORT=587
TZ=Europe/Paris

Chaque ligne ci-dessus correspond à une ligne Nom / Valeur dans la console.

Le bouton Recharger relit les variables enregistrées, sans rien modifier.

Règles et limites

Les clés système de l’application (base de données, secrets) sont protégées et ne peuvent pas être modifiées.
Certains préfixes sont réservés ; la liste est affichée en bas de la vue (« Préfixes réservés (non modifiables) »).
50 variables au maximum, 4 096 caractères au maximum par valeur.
Si l’application définit déjà une variable du même nom, c’est sa valeur qui s’applique.

En cas de problème

« Nom de variable invalide : … » : utilisez uniquement des lettres, des chiffres et _, sans commencer par un chiffre, par exemple MA_VARIABLE.
« Prefixe reserve : … » : le nom commence par un préfixe réservé. Choisissez un autre nom.
« Variable en double : … » : le même nom apparaît deux fois dans la liste.
« Le service doit etre actif pour modifier les variables d’environnement » : attendez la fin du déploiement ou d’une restauration.
L’application ne démarre plus après l’enregistrement : retirez la dernière variable ajoutée, enregistrez de nouveau, puis consultez les journaux.