Skip to content

Configuration

Zyphro3D edited this page Jun 25, 2026 · 1 revision

Configuration

Toutes les variables sont définies dans le fichier .env à la racine du projet. Copier .env.example comme base et renseigner les valeurs.

⚠️ Le fichier .env n'est jamais versionné (il est dans .gitignore). Ne le commitez pas.

Les variables peuvent aussi être modifiées depuis l'interface web via Paramètres (superadmin uniquement) sans accès SSH. Voir Paramètres.


Général

Variable Description Défaut
SECRET_KEY Clé secrète Flask — obligatoire en production
ADMIN_USERNAME Nom du compte admin admin
ADMIN_PASSWORD Mot de passe admin — obligatoire
SUPERADMIN_USERNAME Nom du compte superadmin superadmin
SUPERADMIN_PASSWORD Mot de passe superadmin — obligatoire
PANEL_URL URL publique (utilisée dans les emails et liens) http://localhost:4300
PANEL_TIMEZONE Fuseau horaire (ex: Europe/Paris) Europe/Paris
DEFAULT_LOCALE Langue par défaut (fr / en / de / es / it) fr
SESSION_COOKIE_SECURE true derrière HTTPS, false en HTTP direct true
PANEL_PORT Port d'écoute du panel 4300
PANEL_GITHUB_URL URL GitHub affichée dans le footer dépôt officiel

Serveur de jeu

Variable Description Défaut
ACESERVER_HTTP_PORT Port HTTP API ACE EVO (enregistrement Kunos) 8081
ACESERVER_TCP_HOST Hôte TCP ACE EVO (inutile en mode docker_split) 127.0.0.1
ACESERVER_TCP_PORT Port TCP ACE EVO 9700
SERVER_NAME Nom affiché dans la liste des serveurs ACE EVO ACE EVO Server
SERVER_MAX_PLAYERS Nombre maximum de joueurs 8

Bot TCP in-game

Le bot TCP se connecte au serveur ACE EVO pour envoyer des messages, détecter les meilleurs tours et alimenter le timing en direct. Laisser ACE_BOT_STEAM_ID vide pour désactiver complètement.

Variable Description Défaut
ACE_BOT_STEAM_ID Steam ID 64-bit du compte bot
ACE_BOT_CAR_MODEL Modèle de voiture pour la connexion du bot preset_190_evo_ii
ACE_BOT_IS_ADMIN true pour envoyer \admin <password> automatiquement false
ACE_BOT_MSG_WELCOME Message de bienvenue (variables : {name}, {discord_url}, {site_url})
ACE_BOT_MSG_DISCORD Message Discord envoyé si DISCORD_INVITE_URL est défini
ACE_BOT_MSG_SITE Message site envoyé si PANEL_URL est défini

En mode multi-serveur, un bot indépendant est démarré pour chaque serveur activé. Chaque bot se connecte au container ACE EVO correspondant.

Voir Bot TCP pour les détails de fonctionnement.


HTTPS / SSL

Variable Description
SSL_CERTFILE Chemin vers le certificat (ex: /etc/letsencrypt/live/domain/fullchain.pem)
SSL_KEYFILE Chemin vers la clé privée (ex: /etc/letsencrypt/live/domain/privkey.pem)

Si les deux variables sont renseignées, le panel démarre en HTTPS via gunicorn. Sinon, il utilise waitress en HTTP.


Discord

Variable Description
DISCORD_WEBHOOK_URL Webhook principal (démarrage / arrêt / crash serveur)
DISCORD_PILOTS_WEBHOOK_URL Webhook pilotes — fallback sur le principal si vide
DISCORD_RACE_WEBHOOK_URL Webhook course (meilleurs tours) — fallback sur le principal si vide
DISCORD_INVITE_URL Lien d'invitation affiché sur la page d'accueil

Emails

Les emails sont utilisés pour les confirmations d'inscription, rejets et rappels d'événements. Laisser MAIL_SERVER vide pour désactiver.

Variable Description Défaut
MAIL_SERVER Serveur SMTP
MAIL_PORT Port SMTP 587
MAIL_USE_TLS STARTTLS true
MAIL_USERNAME Identifiant SMTP
MAIL_PASSWORD Mot de passe SMTP
MAIL_FROM Adresse expéditeur
MAIL_ADMIN Adresse(s) admin pour les notifications (séparer par virgule)

Sécurité

Variable Description Défaut
RESULTS_INGEST_SECRET Secret HMAC-SHA256 pour le webhook de résultats

Si RESULTS_INGEST_SECRET est vide, le webhook /api/results/ingest accepte uniquement les requêtes depuis le réseau local.

Clone this wiki locally