Documentation · Guides

Variables d’environnement et secrets.

La configuration vit hors de votre code. Définissez des variables par projet dans le tableau de bord; elles sont présentes dans votre build et injectées dans votre application — chiffrées au repos dans les deux cas.

Définir des variables

Ouvrez l’onglet Variables d’environnement de votre projet et ajoutez des paires clé/valeur. Pour migrer une application existante, collez votre fichier .env entier dans l’éditeur en lot — il comprend le format standard :

DATABASE_URL=postgres://…
STRIPE_SECRET_KEY=sk_live_…
RESEND_API_KEY=re_…

Les changements s’appliquent au prochain déploiement — redéployez après modification pour que le build et le processus en cours voient tous deux les nouvelles valeurs.

Variables sensibles

Marquez une variable sensible et sa valeur devient en écriture seule : elle atteint toujours votre application normalement, mais le tableau de bord ne l’affiche plus jamais. À utiliser pour les clés API, les jetons et tout ce que vous ne voudriez pas voir par-dessus votre épaule.

Build ou exécution

Les variables sont présentes pendant le build et à l’exécution. La distinction qui compte est la règle d’exposition au navigateur de votre cadriciel :

  • Next.js — le code navigateur ne voit que NEXT_PUBLIC_*, intégré au build.
  • Vite — le code navigateur ne voit que VITE_* via import.meta.env, intégré au build.
  • Serveurs (Node, Python, Go, …) — lisent tout depuis l’environnement à l’exécution; aucune règle de préfixe.

Variables que Canner définit pour vous

  • PORT — le port sur lequel votre serveur doit écouter.
  • DATABASE_URL — définie automatiquement quand vous provisionnez une base Postgres.
  • NODE_ENV=production pour les builds et exécutions Node.

Les déploiements d’aperçu partagent les variables du projet — si un aperçu a besoin de valeurs différentes (une API de préproduction, par exemple), c’est le signe qu’il lui faut son propre projet.