Documentation

Configurer à la main.

Presque tout se règle dans l'administration. Le reste — les secrets, le domaine, la base de données — vit dans un seul fichier, le .env, que les mises à jour ne touchent jamais. Voici les deux, réglage par réglage.

Dans l'administration : le menu Réglages

Ce qui change l'allure ou le comportement du site se règle en ligne, sans terminal ni redémarrage.

Général — logo, favicon, langue de l'administration, langues du site, et le bouton « Vider le cache ».
Identité et réseaux sociaux — nom, coordonnées, liens vers vos réseaux.
Polices, Thème, CSS global — la typographie, la palette de couleurs, et en dernier recours quelques règles CSS communes.
Médiathèque — les images, déclinées automatiquement en cinq largeurs.
Connexions sociales — Google, Apple, Facebook pour la connexion des clients.
API Google — la clé des mesures PageSpeed.
Serveur e-mail — serveur SMTP, port, identifiant, mot de passe (chiffré en base).
E-mails envoyés, Cookies, Pages légales — le texte des messages, le bandeau de consentement, mentions, CGU et CGV.
Agents IA — les comptes et jetons qui permettent à Claude de piloter le site.
Mettre à jour JEIKO — la version installée et la mise à jour d'un clic.

Stripe se règle dans Boutique › Moyens de paiement, l'agenda Google dans Rendez-vous › Connexion Google, l'hébergement vidéo des formations dans Formations › Hébergement vidéo.

Le fichier .env

C'est le seul endroit où un site diffère d'un autre. Le settings.py, lui, est identique partout et remplacé à chaque mise à jour : un réglage écrit dedans disparaîtrait au premier clic sur « Mettre à jour ». L'installeur génère le .env et le protège : lisible par le seul compte du site.

/var/www/monsite/monsite/.env # à côté de settings.py, droits 0600

Variable	Défaut	Rôle
`SECRET_KEY`	générée	Clé secrète de Django ; dérive aussi la clé qui chiffre les secrets en base.
`SECRET_KEY_FALLBACKS`	vide	Anciennes clés, séparées par des virgules, le temps d'une rotation.
`JEIKO_SALT_KEY`	dérivé de SECRET_KEY	Sel du chiffrement des secrets.
`DEBUG`	False	Jamais True en production.
`JEIKO_SITE_NAME`	nom du dossier	Nom technique du site.
`DOMAIN_NAME`	vide	Domaine servi, sans https://.
`JEIKO_SSL`	False	HTTPS : redirection, HSTS, cookies sécurisés. À True seulement une fois le certificat en place.
`DB_NAME`, `DB_USER`, `DB_PASS`	—	Base PostgreSQL du site.
`GUNICORN_SOCKET`	—	Socket du service applicatif, posée par l'installeur.
`JEIKO_LANGUAGE`	fr-fr	Langue d'origine du site.
`JEIKO_TIMEZONE`	Europe/Paris	Fuseau horaire : rendez-vous, e-mails, journaux.
`JEIKO_SANITIZE_HTML`	True	Retire scripts et attributs dangereux du HTML saisi. Ne le passer à False que si tous les rédacteurs sont de confiance.
`JEIKO_TRUST_X_FORWARDED_FOR`	True	Lit l'adresse du visiteur transmise par Nginx. À False si Gunicorn est exposé directement.
`JEIKO_AGENTS_APPELS_PAR_HEURE`	600	Plafond d'appels par heure et par jeton d'agent (chaque agent peut avoir le sien).
`JEIKO_AGENTS_ECHECS_PAR_IP`	20	Jetons invalides tolérés par adresse en quinze minutes.
`JEIKO_UPDATE_REQUIRES_SUPERUSER`	True	Réserve la mise à jour aux superutilisateurs.
`JEIKO_UNVERIFIED_ACCOUNT_TTL_DAYS`	30	Comptes jamais confirmés : supprimés après ce délai.
`JEIKO_USER_SESSIONS_RETENTION_DAYS`	30	Conservation de l'historique des sessions.
`JEIKO_SECURITY_EVENTS_RETENTION_DAYS`	365	Conservation du journal de sécurité.

Appliquer un changement

Le .env n'est lu qu'au démarrage du service. Après une modification, redémarrez-le :

sudo nano /var/www/monsite/monsite/.env
sudo systemctl restart gunicorn-monsite
sudo systemctl status gunicorn-monsite # doit dire « active (running) »

Changer la SECRET_KEY

Elle protège les sessions et chiffre les secrets stockés en base — clés Stripe, mot de passe SMTP, identifiants des fournisseurs. La changer sans précaution rend ces secrets illisibles.

SECRET_KEY="nouvelle-clé"
SECRET_KEY_FALLBACKS="ancienne-clé"

# redémarrer, réenregistrer les écrans concernés (Stripe, Serveur e-mail…),
# puis retirer l'ancienne clé et redémarrer à nouveau

Si une valeur de durée est illisible, le site démarre quand même : les purges retombent sur leur valeur par défaut.

Installation Installation automatique