diff --git a/README.md b/README.md
old mode 100644
new mode 100755
index 912d1f2e..375ffdef
--- a/README.md
+++ b/README.md
@@ -99,6 +99,25 @@ Lancer le script:
 Ce script crée une base nommée `SCO8USERS`, appartenant à l'utilisateur (role) postgres `scodoc`.
 Cet utilisateur est automatiquement créé si nécessaire.
 
+### variables d'environnement
+Le serveur utilise des variables d'environnement donnant la configuration de base.
+Le plus simple est de les grouper dans un fichier `.env` (dans `/opt/scodoc/.env`) 
+qui est lu automatiquement au démarrage:
+
+    # .env for ScoDoc _development_
+
+    FLASK_APP=scodoc.py
+    FLASK_ENV=development
+
+    MAIL_SERVER=votre.serveur.de.mail.net # ou vide si pas de mail
+    MAIL_PORT=25
+
+    SCODOC_ADMIN_MAIL="adresse.admin@toto.fr" # important: le mail de admin
+    USERS_DATABASE_URI="postgresql://scodoc:le_mot_de_passe@localhost:5432/SCO8USERS"
+    SECRET_KEY="CGGAJAKlh6789JJK?KNAb=" # une chaine aléatoire
+    # comment out to use CDN:
+    BOOTSTRAP_SERVE_LOCAL=1
+
 ### Initialisation de la base utilisateur par Flask
 
 En tant qu'utilisateur `scodoc`: