Référence de configuration

Chaque réglage est une variable d’environnement, lue au démarrage. Définissez-les dans votre .env. Cette page les liste par usage avec leurs valeurs par défaut.

Cœur et stockage

Variable	Défaut	Rôle
ANON_DB_KEY	requis	Clé de chiffrement des données au repos (la table d’anonymisation et les comptes liés). Sauvegardez-la dans un coffre-fort. Si elle est perdue ou changée sur une instance qui contient déjà des données, la table devient illisible.
ANON_LANGUAGE	fr	Langue de détection par défaut (fr ou en).
ANON_DATA_DIR	./data	Répertoire de données (base SQLite, table chiffrée, comptes liés). À monter en volume.
ANON_DB_PATH	./data/conversations.db	Chemin de la base SQLite.
ANON_PORT	8500	Port hôte exposé par le conteneur (défini dans le fichier compose).

Authentification

Variable	Défaut	Rôle
AUTH_BACKEND	local	local ou ldap.
WEBAPP_USERS	vide	Comptes locaux de bootstrap, format user:motdepasse,user2:motdepasse2. Le premier compte créé devient admin.
WEBAPP_USER / WEBAPP_PASSWORD	admin / admin	Repli mono-compte pour un premier démarrage. À changer.
LDAP_SERVER, LDAP_BASE_DN, LDAP_SEARCH_FILTER, LDAP_BIND_DN, LDAP_BIND_PASSWORD, LDAP_USE_SSL, LDAP_USER_DN_TEMPLATE, LDAP_REQUIRE_GROUP_DN	vide	Réglages LDAP ou Active Directory, utilisés quand AUTH_BACKEND=ldap. Voir le guide d’installation.

Licence (édition commerciale)

Variable	Défaut	Rôle
LICENSE_KEY	vide	Le token de licence signé. Requis pour l’édition commerciale.
LICENSE_SERVER_URL	vide	Serveur de licence pour la validation périodique et la révocation. À laisser vide seulement pour une instance totalement air-gap.
LICENSE_PHONE_HOME_INTERVAL	86400	Secondes entre deux vérifications de licence.
LICENSE_GRACE_PERIOD_DAYS	14	Grâce réseau après la dernière vérification réussie avant qu’une instance activée se suspende.
LICENSE_NO_LICENSE_GRACE_DAYS	15	Grâce avant qu’une instance sans licence se suspende.

Clés API et rate limiting

Variable	Défaut	Rôle
API_KEY_DAILY_QUOTA	500	Appels par clé API et par jour. 0 = illimité.
RATE_LIMIT_ENABLED	true	Limitation de débit applicative.
RATE_LIMIT_DEFAULT_PER_MIN	150	Requêtes par minute par client par défaut.
RATE_LIMIT_AUTH_PER_MIN	10	Requêtes par minute sur le chemin de connexion.
RATE_LIMIT_LLM_PER_MIN	40	Requêtes par minute sur les appels de modèle.
LOGIN_IP_MAX_ATTEMPTS	20	Connexions échouées par IP avant blocage.
COOKIE_SECURE	true	Cookie de session envoyé uniquement en HTTPS, et signal qui active HSTS. À mettre à false seulement pour un test local en HTTP.

Fichiers et OCR

Variable	Défaut	Rôle
FILE_UPLOAD_MAX_BYTES	20971520	Taille max d’upload (20 Mo).
FILE_OCR_MAX_PAGES	30	Pages max traitées par OCR par document.
FILE_OCR_MAX_WORKERS	min(8, CPUs)	Parallélisme OCR.

Cache

Variable	Défaut	Rôle
MODELS_CACHE_TTL	1800	Secondes de cache du catalogue de modèles live.
EXT_ANON_CACHE_TTL	3600	Secondes de cache d’une session d’anonymisation pour l’extension et l’API.
EXT_ANON_CACHE_MAX	200	Nombre max de sessions en cache.