# Variables et secrets

> Ajouter des variables d'environnement une à une ou depuis un fichier .env, protéger un secret, citer une autre variable, exporter.

Source : https://docs.fransys.cloud/projets/variables-et-secrets/ Vérifié sur la console le 2026-10-23.

## Ajouter une variable

Dans le panneau du service, rubrique des variables d'environnement, mode **Une variable** : un nom, une valeur, puis **Ajouter**. La variable s'applique au prochain déploiement du projet.

Trois options par variable :
- **Exposer aux services reliés** : les services reliés à celui-ci reçoivent cette variable ;
- **Protégée** : la valeur est chiffrée et illisible ensuite, même pour vous. Gardez-en une copie en lieu sûr ;
- **Autoriser les références** : la valeur peut citer une autre variable, par exemple `${APP_URL}/api`. Elle est remplacée au déploiement.

## Importer un fichier .env

Mode **Plusieurs variables (.env)** : collez le contenu du fichier, une variable par ligne (`CLE=valeur`). Les commentaires `#`, les valeurs entre guillemets et les lignes vides sont acceptés. Les noms sont mis en majuscules.

L'**Aperçu avant import** montre les variables reconnues, celles déjà présentes et les lignes ignorées, avec la raison (pas de signe `=`, guillemet jamais fermé…). Pour chaque nom déjà présent, choisissez :
- garder la valeur actuelle ;
- remplacer la valeur actuelle ;
- importer sous un autre nom (suffixe `_2`).

Les options (exposée, protégée, références) s'appliquent à toutes les variables importées. Gardez le panneau ouvert jusqu'à la fin de l'import.

## Exporter

**Exporter les variables** donne le contenu au format `.env`, à copier ou à télécharger. Les valeurs protégées ne sont pas lisibles : elles figurent en commentaire (`# CLE=`), à compléter à la main. Les variables reçues des services reliés ne sont pas incluses.

## Variables reçues

Les variables qui viennent d'un service relié (une base, par exemple) portent la mention **reçue d'un service relié**. Vous ne les modifiez pas ici, mais vous pouvez les renommer. Voir [Relier des services](https://docs.fransys.cloud/projets/relier-des-services/).

## Variables lues au build

Les variables lues pendant la construction de l'image (par exemple `VITE_…`) ne sont pas encore transmises par la CI de Fransys. Gardez-les dans votre code, ou lisez-les au démarrage de l'application.