Installation

Du téléchargement au premier serveur.

Choisissez votre système. Installez d'abord le serveur dédié officiel via Steam. Les scripts de démarrage sont dans le paquet ACEvo extrait.

Windows Linux Docker Premier serveur Après l’installation

1. Ce dont vous avez besoin au préalable

Windows convient pour démarrer sur votre propre PC. Pour un serveur fonctionnant en permanence, l'installateur automatique Debian est le chemin le plus court. Docker nécessite une expérience avec les conteneurs et un MariaDB existant.

WindowsRecommandé pour le moyen le plus simple de démarrer sur un PC ou un serveur Windows.

LinuxConvient à un serveur fonctionnant en permanence. Le serveur de jeu officiel Windows nécessite Wine et Xvfb.

DockerPour les utilisateurs connaissant déjà Docker ou souhaitant un déploiement reproductible.

Exigence	Devoir?	Pourquoi?
Assetto Corsa EVO Dedicated Server sur Steam	Oui	ACEvo gère le serveur officiel, mais ne fournit pas ses fichiers.
Java 21 ou version ultérieure	Oui	ACEvo est une application Web Java.
Wine + Xvfb	Linux uniquement	Pour que le Windows-EXE du Dedicated Server officiel puisse fonctionner sans bureau.
MariaDB	Non	Par défaut, une base de données de fichiers H2 intégrée est utilisée.
Docker	Variante Docker uniquement	Non requis pour l'installation ZIP de Windows ou Linux.

Règle de sécurité : Ouvrez ACEvo uniquement sur le réseau local lors du premier test. Ne transférez pas de ports vers Internet tant que le mot de passe administrateur, le pare-feu, HTTPS/Reverse Proxy et les sauvegardes n'ont pas été consciemment configurés.

2. Installation rapide par système d'exploitation

Windows utilise le zip du lanceur. Sur Debian, le script Linux installe automatiquement ACEvo et le Dedicated Server officiel.

Windows : ZIP du lanceur

Dans Steam, ouvrez Bibliothèque → Outils et installez Assetto Corsa EVO Dedicated Server.
Installez un environnement d'exécution Java-21. Ceci convient pour Windows Temurin-21-JDK pour Windows x64 en tant que MSI. Dans la boîte de dialogue d'installation, l'option permettant d'ajouter Java au PATH laisser activé.
Téléchargez le ZIP du launcher ACEvo et décompressez-le complètement dans un dossier fixe, par exemple C:\ACEvo.
Avant de démarrer pour la première fois, définissez les mots de passe administrateur et base de données (section Installation complète de Windows). Puis démarrez dans le dossier décompressé scripts\start-app-windows.cmd et ouvert http://localhost:8082.

L'installation ZIP configure ACEvo. Les Dedicated Server et Java officiels doivent être installés au préalable.

Linux : installateur Web Debian

La méthode automatique est destinée à Debian. Ouvrez un terminal, téléchargez le script et exécutez le bloc. Aucun caractère ni astérisque n'apparaît lors de la saisie des mots de passe ; tapez quand même et appuyez sur Entrée. Sudo peut alors demander le mot de passe de votre compte Linux.

sudo apt update
sudo apt install -y curl
curl -fsSL https://acevo-server.com/linux/install.sh -o /tmp/acevo-install.sh
(
  set -e
  read -rp "Nom du compte Steam : " STEAM_LOGIN
  read -rp "Utilisateur H2 : " DB_USER
  read -rsp "Mot de passe de la base H2 : " DB_PASSWORD
  printf '\n'
  read -rsp "Mot de passe administrateur ACEvo : " GUI_ADMIN_PASSWORD
  printf '\n'
  export STEAM_LOGIN DB_USER DB_PASSWORD GUI_ADMIN_PASSWORD
  export ACEVO_PORT=8082 ACEVO_HOME=/opt/acevo ACE_SERVER_HOME=/opt/ace-server
  export ACEVO_CONFIG_DIR=/etc/acevo ACEVO_SERVICE_USER=acevo
  sudo --preserve-env=STEAM_LOGIN,DB_USER,DB_PASSWORD,GUI_ADMIN_PASSWORD,ACEVO_PORT,ACEVO_HOME,ACE_SERVER_HOME,ACEVO_CONFIG_DIR,ACEVO_SERVICE_USER bash /tmp/acevo-install.sh
)

Entrées : Nom du compte Steam, utilisateur H2, mot de passe personnalisé H2 et mot de passe administrateur personnalisé ACEvo. SteamCMD interroge le mot de passe de Steam et, si nécessaire, Steam Guard lui-même. Ne saisissez jamais votre mot de passe Steam dans la commande. Les informations d'identification H2 ne sont pas des informations d'identification MariaDB et le mot de passe H2 ne chiffre pas le fichier de base de données.

Avant d'exécuter, vous pouvez modifier le port Web, le dossier d'installation, le dossier du serveur de jeu, le dossier de configuration et l'utilisateur du service dans le bloc. Utilisez des chemins absolus Linux sans espaces. Le programme d'installation ajoute les référentiels Debian, installe Java, SteamCMD et Wine, télécharge ACEvo et le serveur de jeu et configure systemd. Il n'ouvre aucun port de routeur. Pas sur Ubuntu ou autres Utilisez des distributions. Si la configuration ou le service ACEvo est présent, le script est abandonné.

Après une exécution réussie, le script vérifie le service et l'accès Web local. Ouvrir http://localhost:8082 sur le serveur ou http://SERVER-IP:8082 du réseau local. Remplacer SERVER-IP par l'adresse IP locale. Lorsque vous vous connectez en tant qu'administrateur pour la première fois, vous utilisez le mot de passe que vous avez choisi précédemment. Il n'y a pas de nom d'utilisateur administrateur.

Afficher le script d'installation Linux

http://localhost:8082 sur l'ordinateur lui-même ou http://SERVER-IP:8082 ouvert dans le réseau local. D'autres paramètres sont disponibles dans les sections Windows et Linux.

3. Terminez l'installation de Windows

Préparez Steam et Dedicated Server

Installez Steam et connectez-vous avec un compte ayant accès à Assetto Corsa EVO. Ensuite, installez l'outil Assetto Corsa EVO Dedicated Server.

Le chemin typique Steam n’est qu’un exemple. Ce qui compte c'est le dossier dans lequel AssettoCorsaEVOServer.exe ment en fait.

Extrayez ACEvo dans un dossier fixe

Exemple: C:\ACEvo. Pour un fonctionnement permanent, évitez les téléchargements ou les dossiers temporaires.

Définir l'accès administrateur avant le premier démarrage

Dans le dossier ACEvo, créez le sous-dossier config. Ouvrez l'éditeur, copiez-y la configuration suivante et remplacez les deux exemples de mots de passe par vos propres valeurs. Enregistrez le fichier sous C:\ACEvo\config\application.properties; Sélectionnez « Tous les fichiers » dans la boîte de dialogue de sauvegarde afin que Windows ne passe pas inaperçu .txt ci-joint. Le fichier contient des mots de passe et ne peut pas être partagé ou téléchargé publiquement.

server.port=8082
acevo.paths.data-dir=C:/ACEvo
spring.datasource.url=jdbc:h2:file:C:/ACEvo/data/acevo-db;MODE=MariaDB;DATABASE_TO_LOWER=TRUE;CASE_INSENSITIVE_IDENTIFIERS=TRUE
spring.datasource.username=acevo
spring.datasource.password=EIN_EIGENES_DB_KENNWORT
spring.datasource.driver-class-name=org.h2.Driver
logging.file.name=C:/ACEvo/logs/acevo-application.log
acevo.security.gui-admin-password-fallback=EIN_EIGENES_ADMIN_KENNWORT

La solution de secours est enregistrée en tant que mot de passe de l'administrateur Web lors de la première connexion réussie. Le fichier contient des secrets. La connexion ne demande qu'un mot de passe, pas un nom d'utilisateur.

Premier démarrage

Double-cliquez scripts\start-app-windows.cmd. Si Windows affiche une requête de pare-feu, autorisez initialement uniquement les réseaux privés.

Puis ouvre-le http://localhost:8082.

Quelles valeurs devez-vous changer ?

Valeur	saisir	Avis
`server.port`	Normalement `8082`	Ne changez que si le port 8082 est déjà utilisé.
`acevo.paths.data-dir`	Dossier inscriptible, par ex. b. `C:/ACEvo`	Les barres obliques évitent les problèmes d'échappement.
`spring.datasource.password`	Propre mot de passe local	N'utilisez pas d'exemple de mot de passe connu publiquement.
Chemin du serveur dédié	Dans l'interface ACEvo, le dossier contenant `AssettoCorsaEVOServer.exe` choisir	Pas le EXE lui-même, mais sélectionnez le dossier approprié.

4. Installation de Linux et pré-configuration administrateur

Sur Debian, le programme d'installation Web est le chemin d'installation recommandé. Il met en place ACEvo et le Dedicated Server officiel. Le fichier du serveur est un Windows-EXE ; Wine et Xvfb s'exécutent sur Linux sans ordinateur de bureau.

Configuration système requise : Debian, un accès Internet et un utilisateur qui sudo peut utiliser. N'exécutez pas ce script sur Ubuntu ou toute autre distribution. Il complète explicitement les sources des paquets Debian.

Valeurs avant installation

Valeur	Devoir	Norme et objectif
`STEAM_LOGIN`	Oui	Nom du compte Steam avec accès au Dedicated Server officiel. Vous saisissez le mot de passe Steam et Steam Guard directement dans SteamCMD.
`DB_USER`	Oui	Utilisateurs de la base de données de fichiers locale H2, par exemple `acevo`. Ce n'est pas un compte MariaDB.
`DB_PASSWORD`	Oui	Mot de passe personnel pour l'accès à la base de données H2. Il ne chiffre pas automatiquement le fichier de base de données sur le disque.
`GUI_ADMIN_PASSWORD`	Oui	Mot de passe personnel pour la première connexion de l'administrateur Web ACEvo. Un nom d’utilisateur administrateur n’est pas utilisé.
`ACEVO_PORT`	Non	Port Web, standard `8082`.
`ACEVO_HOME`	Non	Dossiers d'applications, de données et de logos, standard `/opt/acevo`.
`ACE_SERVER_HOME`	Non	Dossier du serveur de jeu, par défaut `/opt/ace-server`.
`ACEVO_CONFIG_DIR`	Non	Dossier de configuration protégé, par défaut `/etc/acevo`.
`ACEVO_SERVICE_USER`	Non	Compte système Linux sous lequel ACEvo s'exécute ; standard `acevo`.
`DOWNLOAD_URL`	Non	Adresse de téléchargement du fichier JAR ACEvo. Conservez la valeur officielle par défaut.

Vous pouvez personnaliser les valeurs facultatives du chemin, du port et de l'utilisateur dans le bloc d'installation rapide. Utilisez des chemins absolus sans espaces. Le script enregistre la base de données et le mot de passe administrateur dans /etc/acevo/install.env avec des droits limités; le service systemd les lit.

Ce que le script fait automatiquement

Il complète les sources des packages Debian et installe Java 21, SteamCMD, Wine, Xvfb et des utilitaires.
SteamCMD téléchargera le Dedicated Server officiel en utilisant votre compte Steam.
Le script crée son propre utilisateur de service Linux, les dossiers de programme, de configuration, de données et de logo, ainsi que le préfixe Wine.
Il charge le fichier JAR ACEvo depuis le site officiel et crée une configuration externe avec le port, la base de données H2, le chemin du serveur de jeu et la solution de secours de l'administrateur.
Il configure le service systemd, active le démarrage automatique et démarre ACEvo.
Enfin, il vérifie les fichiers du serveur de jeu et le port Web local.

Il ne configure pas MariaDB, n'ouvre aucun port de pare-feu ou de routeur, ni ne configure aucune instance de serveur de jeu. Une configuration ou un service ACEvo existant entraînera l'abandon du programme d'installation pour des raisons de sécurité. Si vous disposez d'une installation existante, sauvegardez d'abord /opt/acevo/data et /etc/acevo.

Vérifier l'installation et trouver les erreurs

Le terminal doit signaler le service comme actif et renvoyer une réponse HTTP. Vous pouvez réexécuter ces commandes à tout moment :

sudo systemctl status acevo --no-pager
sudo journalctl -u acevo -n 100 --no-pager
curl -I http://127.0.0.1:8082/

Remplacer 8082, si vous avez choisi un autre port Web. Si une erreur se produit, lisez d'abord les messages dans le journal de service. Les causes courantes incluent le manque d'accès à Steam, une procédure Steam Guard incorrecte, des ports occupés ou une mémoire libre insuffisante.

Données d'administration et de serveur de jeu après le lancement

Connectez-vous avec le mot de passe administrateur ACEvo que vous avez défini précédemment. Si possible, modifiez-le dans la configuration ACEvo. Si vous ne souhaitez pas accepter définitivement le repli externe, supprimez la ligne acevo.security.gui-admin-password-fallback de /etc/acevo/application.properties et redémarrez le service. Vous pourrez ultérieurement définir le nom du serveur de jeu, le mot de passe administrateur du serveur de jeu, l'itinéraire et les sessions de course par instance dans ACEvo ; le programme d'installation de Linux n'accepte pas ces valeurs.

Si vous n'utilisez pas Debian

Ne démarrez pas le programme d'installation Web. Le zip du lanceur contient le programme ACEvo et des exemples de configuration, mais ne configure pas automatiquement SteamCMD, Wine, les autorisations et un service Systemd. Pour les autres distributions Linux, un administrateur doit configurer les packages appropriés et systemd se lance lui-même.

5. Installation du Docker

Important: Le code source examiné ZIP ne contient aucun fichier Compose ou Docker. Le site Web actuel décrit un package Docker distinct à cet effet. Utilisez cette section uniquement avec la version publiée Docker, qui compose.yaml, compose.local-mariadb.yaml, Dockerfile.local et contient des exemples de configurations.

Le ZIP contient le fichier prédéfini acevo-server.jar dans le dossier principal. Le fichier Docker vous attend sur target/acevo-server-1.0.0-SNAPSHOT.jar. Copiez-le là avant de commencer. Dans PowerShell :

New-Item -ItemType Directory -Force target
Copy-Item acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar

En bash, vous utilisez mkdir -p target et cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. Le ZIP Docker ne contient pas de projet Maven. Utiliser sur Windows scripts/docker-up.ps1 -NoBuild ou démarrez Docker Compose directement docker compose up -d --build.

Décompressez le package Docker

Vérifiez si au moins ces fichiers sont présents :

compose.yaml
compose.local-mariadb.yaml
Dockerfile.local
config/application-docker.properties.sample
config/acevo-docker.env.sample
config/acevo-local-mariadb.env.sample

Copier des exemples de fichiers

cp config/application-docker.properties.sample config/application-docker.properties
cp config/acevo-docker.env.sample config/acevo-docker.env
cp config/acevo-local-mariadb.env.sample config/acevo-local-mariadb.env

Toutes valeurs incluses CHANGE_ME remplaçant.

Monter le dossier du serveur dédié

Le dossier compose.local-mariadb.yaml contient un exemple de chemin d'accès à partir d'une installation de développeur. Remplacez-le par le dossier hôte réel par AssettoCorsaEVOServer.exe. Le package Docker lance uniquement l'application Web et ne configure pas le Dedicated Server.

Démarrer le conteneur

docker compose -f compose.yaml -f compose.local-mariadb.yaml -p acevo_local up -d --build

Test: docker compose -p acevo_local ps montre les conteneurs en cours d'exécution. Puis ouvre-le http://localhost:8082.

Entrées requises

Valeur	Signification
Nom de la base de données MariaDB	Par exemple `acevo`; doit être le même dans la configuration de l'application et de la base de données.
Utilisateur MariaDB	Propre utilisateur, pas aveugle `root` utiliser.
Mot de passe MariaDB	Mot de passe long et unique ; identique dans les deux configurations.
Mot de passe administrateur	Propre mot de passe pour l'accès administrateur ACEvo.
Chemin d'accès de l'hôte Dedicated Server	Chemin absolu vers le dossier avec `AssettoCorsaEVOServer.exe`.
Port Internet	Par défaut `8082`, sauf mappage contraire.

6. Créez le premier serveur dans ACEvo

Accès administrateur sécurisé

L'administrateur Web n'utilise qu'un seul mot de passe. Vous pouvez le modifier dans la configuration ACEvo. Un repli externe défini reste également valable : supprimez-le uniquement après avoir enregistré un nouveau mot de passe, puis redémarrez ACEvo.

Modifiez immédiatement un mot de passe par défaut ou de secours existant. N'utilisez pas de mot de passe provenant d'un exemple de configuration.

Sélectionnez le dossier du serveur dédié

Sélectionnez le dossier dans lequel AssettoCorsaEVOServer.exe, cars.json, events_practice.json et events_race_weekend.json poser.

Entrez les ports

Pour la première fois, les zones suivantes sont fournies dans le modèle :

ACE TCP: 9700
ACE UDP: 9700
ACE HTTP: 8091
ACEvo Web UI: 8082

Pour chaque instance suivante, les ports du serveur de jeu doivent être uniques, par ex. Par ex. 9701/9701/8092.

Le port Web ACEvo 8082 en est séparé. Le programme d'installation n'ouvre pas le pare-feu ou le routeur. Pour les jeux publics, libérez uniquement les ports du serveur de jeu indiqués dans ACEvo, y compris le protocole TCP ou UDP. Ne transférez pas le port Web directement vers Internet ; utilisez HTTPS avec un proxy inverse.

Sélectionnez Configuration

Configurez l'itinéraire, le mode, les sessions, les véhicules, le nombre de joueurs et la météo. Selon l'aide intégrée, aucune sélection de véhicule signifie : tous les véhicules sont autorisés.

Commencez et vérifiez

Démarrez l'instance dans ACEvo et vérifiez l'état et le journal.

Examen Linux : ss -tulpn | grep -E "9700|8091"

7. Problèmes courants

Le site Web ne s'ouvre pas

Vérifiez la console de démarrage pour les erreurs et si le port est correct. La norme ici est cohérente 8082. Test http://localhost:8082.

« java » n'a pas été trouvé

Java 21 n'est pas installé ou n'est pas dans le PATH. Après l'installation, démarrez un nouveau terminal et vérifiez java -version.

Le Dedicated Server ne démarre pas

Vérifiez le dossier et les fichiers. Sous Linux, en plus Wine, Xvfb, les droits et le dossier du logo ACEvo.

Port déjà occupé

Soit changer server.port pour ACEvo ou les ports de l'instance de serveur de jeu concernée. Chaque instance nécessite des ports uniques.

Le serveur est ouvert localement mais n'est pas visible dans le jeu

Si TCP/UDP écoute localement, la cause peut être externe à ACEvo, comme un pare-feu, le partage de routeur ou la connexion au backend du jeu. N'ouvrez pas les ports de manière générale, mais seulement de manière spécifique.

8. Après l'installation

Arrêtez ACEvo avant de copier la base de données du fichier H2. Sécurisez les données et la configuration séparément :

Windows : le dossier acevo.paths.data-dir et config\application.properties.
Debian : /opt/acevo/data, /etc/acevo/application.properties et le dossier confidentiel /etc/acevo/install.env.
Docker : le dossier de données persistantes et les vrais fichiers de configuration. Ne supprimez pas les volumes de base de données.

SauvegardeSécurisez régulièrement les dossiers de données, la configuration et – avec MariaDB – la base de données.

Mises à jourSauvegardez avant les mises à jour, lisez les notes de version et examinez les modifications de configuration.

Opération publiqueHTTPS, configurez un proxy inverse, un pare-feu, des mots de passe forts et une politique de confidentialité appropriée.

Télécharger ACEvo Vers la page d'accueil

Si le démarrage échoue

Vérifiez Java, le journal de démarrage, le chemin du serveur et le port configuré. Si le port est occupé, modifiez server.port et utilisez ce même port dans le navigateur. La base H2 intégrée suffit pour commencer.

Télécharger gratuitement ?Envoyer un e-mail