Installation

Installation

Ce guide couvre l'installation complète du panel sur un serveur Linux avec Docker.

Prérequis : Debian/Ubuntu (ou tout Linux 64-bit), Docker + Docker Compose, un compte Steam avec ACE EVO.

---

1. Télécharger le serveur ACE EVO via SteamCMD

ACE EVO tourne sous Windows — SteamCMD permet de télécharger les fichiers serveur sur Linux.

# Installer SteamCMD (Debian/Ubuntu)
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install -y lib32gcc-s1

mkdir -p /opt/steamcmd && cd /opt/steamcmd
curl -fsSL https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz | tar xz

# Télécharger les fichiers serveur ACE EVO
/opt/steamcmd/steamcmd.sh \
  +@sSteamCmdForcePlatformType windows \
  +login TON_COMPTE_STEAM \
  +force_install_dir /opt/aceserver \
  +app_update 4564210 validate \
  +quit

⚠️ Remplace TON_COMPTE_STEAM par ton identifiant Steam. SteamCMD te demandera ton mot de passe et éventuellement le code Guard.

---

2. Cloner le panel et copier les fichiers serveur

git clone https://github.com/Zyphro3D/pannel-ac-evo-server.git /opt/pannel-ac-evo-server

# Copier les binaires ACE EVO dans le dossier du panel
mkdir -p /opt/pannel-ac-evo-server/aceserver/configs
cp -r /opt/aceserver/* /opt/pannel-ac-evo-server/aceserver/

---

3. Configurer le fichier .env

cd /opt/pannel-ac-evo-server
cp .env.example .env
nano .env

Variables obligatoires à renseigner :

SECRET_KEY=           # générer : python3 -c "import secrets; print(secrets.token_hex(32))"
ADMIN_PASSWORD=       # mot de passe du compte admin
SUPERADMIN_PASSWORD=  # mot de passe du compte superadmin
PANEL_URL=            # ex: https://mondomaine.fr ou http://192.168.1.10:4300
SESSION_COOKIE_SECURE=true   # mettre false si HTTP sans reverse proxy

Voir Configuration pour la référence complète de toutes les variables.

---

4. Lancer le panel

docker compose up -d --build

Deux containers sont construits et démarrent :

Container	Rôle	Ports
ace-panel	Interface web Flask	4300
ace-server	Wine + AssettoCorsaEVOServer.exe	9700 TCP/UDP, 8081 HTTP

⏱️ Le premier démarrage prend environ 5 minutes (build des images + initialisation Wine).

# Suivre les logs
docker compose logs -f panel      # logs du panel uniquement
docker compose logs -f aceserver  # logs du serveur de jeu
docker compose logs -f            # tous les logs

Le panel est accessible sur http://IP:4300.

Identifiants par défaut :

• Admin : admin / (mot de passe défini dans .env)
• Superadmin : superadmin / (mot de passe défini dans .env)

---

5. Ouvrir les ports réseau

Configurez votre box/routeur/firewall pour autoriser :

Port	Protocole	Usage
9700	UDP + TCP	Joueurs ACE EVO (connexion en jeu)
8081	TCP	API HTTP ACE EVO (enregistrement Kunos)
4300	TCP	Panel web (HTTP direct)
443	TCP	Panel web (HTTPS via reverse proxy)

Multi-serveur : chaque serveur supplémentaire a ses propres ports (ex. serveur 2 : 9701 UDP/TCP + 8082 HTTP). Voir Multi-serveur.

---

6. HTTPS (optionnel)

Option A — HTTP direct (défaut)

Aucune configuration supplémentaire. Le panel écoute sur http://IP:4300.

Option B — HTTPS intégré (Let's Encrypt)

sudo apt install certbot
sudo certbot certonly --standalone -d votre-domaine.fr

Dans .env :

PANEL_PORT=443
SSL_CERTFILE=/etc/letsencrypt/live/votre-domaine.fr/fullchain.pem
SSL_KEYFILE=/etc/letsencrypt/live/votre-domaine.fr/privkey.pem
SESSION_COOKIE_SECURE=true

Dans docker-compose.yml, décommenter :

- /etc/letsencrypt:/etc/letsencrypt:ro

Après renouvellement du certificat :

docker compose restart panel

Option C — Reverse proxy (Nginx, Caddy…)

Laissez le panel sur HTTP port 4300 et gérez le SSL côté proxy. Assurez-vous que SESSION_COOKIE_SECURE=true dans .env.

---

Structure du dossier après installation

/opt/pannel-ac-evo-server/
├── aceserver/
│   ├── AssettoCorsaEVOServer.exe   ← binaire (non versionné)
│   ├── cars.json                   ← liste des voitures
│   ├── events_practice.json        ← modèles practice
│   ├── events_race_weekend.json    ← modèles race weekend
│   ├── configs/                    ← fichiers de config JSON
│   └── results/                    ← résultats de sessions
├── media/                          ← images circuits/voitures/bannières
├── .env                            ← secrets (non versionné)
├── docker-compose.yml
└── ...