Variables d'environnement · docs socAdmin

Tous les paramètres sont optionnels. socAdmin démarre sans configuration et génère ce dont il a besoin au premier lancement.

Serveur

Variable	Défaut	Description
`PORT`	`8080`	Port HTTP ou HTTPS sur lequel socAdmin écoute.
`DATA_DIR`	répertoire courant ; `/data` sous Docker	Emplacement de `socadmin.db`. Créé s’il n’existe pas.
`TLS_CERT`	—	Chemin vers un certificat TLS. Avec `TLS_KEY`, socAdmin sert du HTTPS.
`TLS_KEY`	—	Chemin vers la clé privée TLS.
`HTTP_REDIRECT_PORT`	`80`	Port de la redirection HTTP vers HTTPS, uniquement lorsque TLS est activé.

Comptes

Variable	Défaut	Description
`ADMIN_EMAIL`	—	Crée ce compte administrateur au démarrage s’il n’existe pas. Nécessite `ADMIN_PASSWORD`.
`ADMIN_PASSWORD`	—	Mot de passe de cet administrateur. 10+ caractères avec majuscule, minuscule, chiffre et caractère spécial, sinon socAdmin refuse de démarrer.
`REGISTRATION_ENABLED`	`true`	Définir à `false` pour que seuls les administrateurs puissent créer des comptes. Le premier compte peut toujours être créé.
`JWT_SECRET`	généré et stocké dans `socadmin.db`	Clé qui signe les tokens de session. Au moins 32 caractères, sinon socAdmin refuse de démarrer. Définissez-la explicitement en production.

Sécurité

Variable	Défaut	Description
`SECURE_COOKIES`	`false`	Définir à `true` pour marquer les cookies `Secure` lorsque le HTTPS se termine au reverse proxy. Automatique quand socAdmin sert du TLS directement.
`TRUSTED_PROXY`	—	IPs ou plages CIDR séparées par des virgules, autorisées à définir `X-Forwarded-For` et `X-Real-IP`. Sans cette variable, les en-têtes proxy sont ignorés.
`ALLOW_PRIVATE_NETWORKS`	`true`, `false` sous Docker	Autorise les connexions aux IPs loopback et privées. Définir à `false` ou `0` pour les bloquer.

Connexions aux bases de données

Pré-remplissez une connexion pour chaque utilisateur. Une connexion est activée dès que son *_HOST est défini. Les trois moteurs peuvent être configurés simultanément.

MySQL / MariaDB

Variable	Défaut	Description
`MYSQL_HOST`	—	Nom d’hôte du serveur. Active la connexion MySQL.
`MYSQL_PORT`	`3306`	Port du serveur.
`MYSQL_USER`	`root`	Utilisateur de la base de données.
`MYSQL_PASSWORD`	—	Mot de passe de la base de données.

PostgreSQL

Variable	Défaut	Description
`POSTGRES_HOST`	—	Nom d’hôte du serveur. Active la connexion PostgreSQL.
`POSTGRES_PORT`	`5432`	Port du serveur.
`POSTGRES_USER`	`postgres`	Utilisateur de la base de données.
`POSTGRES_PASSWORD`	—	Mot de passe de la base de données.

MongoDB

Variable	Défaut	Description
`MONGO_HOST`	—	Nom d’hôte du serveur. Active la connexion MongoDB.
`MONGO_PORT`	`27017`	Port du serveur.
`MONGO_USER`	—	Utilisateur, si l’authentification est activée.
`MONGO_PASSWORD`	—	Mot de passe, si l’authentification est activée.

Flags en ligne de commande

Flag	Description
`--reset-password <email>`	Définit un nouveau mot de passe pour un compte de manière interactive, puis se termine. Voir Réinitialiser un mot de passe.