Installatie

Van download naar je eerste server.

Kies je systeem. Installeer eerst de officiële dedicated server via Steam. De startscripts staan in het uitgepakte ACEvo-pakket.

Windows Linux Docker Eerste server Na installatie

1. Wat je vooraf nodig hebt

Windows is geschikt om op uw eigen PC aan de slag te gaan. Voor een permanent werkende server is het automatische installatieprogramma van Debian de kortste weg. Docker vereist ervaring met containers en een bestaande MariaDB.

WindowsAanbevolen voor de eenvoudigste manier om aan de slag te gaan op een pc of Windows-server.

LinuxGeschikt voor een permanent draaiende server. De officiële Windows-spelserver vereist Wine en Xvfb.

DockerVoor gebruikers die Docker al kennen of een reproduceerbare implementatie willen.

Vereiste	Plicht?	Waarom?
Assetto Corsa EVO Dedicated Server boven Steam	Ja	ACEvo beheert de officiële server, maar levert de bestanden niet.
Java 21 of nieuwer	Ja	ACEvo is een Java-webapplicatie.
Wine + Xvfb	Alleen Linux	Zodat de Windows-EXE van de officiële Dedicated Server zonder desktop kan draaien.
MariaDB	Nee	Standaard wordt een ingebedde bestandsdatabase H2 gebruikt.
Docker	Alleen Docker-variant	Niet vereist voor Windows of Linux ZIP-installatie.

Veiligheidsregel: Open ACEvo alleen in het lokale netwerk tijdens de eerste test. Stuur geen poorten door naar internet totdat het beheerderswachtwoord, de firewall, HTTPS/Reverse Proxy en back-ups bewust zijn ingesteld.

2. Snelle installatie per besturingssysteem

Windows gebruikt de launcher-zip. Op Debian installeert het script Linux automatisch ACEvo en de officiële Dedicated Server.

Windows: Launcher-ZIP

Open in Steam Bibliotheek → Tools en installeer Assetto Corsa EVO Dedicated Server.
Installeer een Java-21-runtime. Deze is geschikt voor Windows Temurin-21-JDK voor Windows x64 als MSI. In het installatiedialoogvenster is de optie om Java toe te voegen aan het PATH geactiveerd laten.
Download het ACEvo-launcher-ZIP-bestand en pak het bijvoorbeeld volledig uit in een vaste map C:\ACEvo.
Voordat u voor de eerste keer start, stelt u de beheerders- en databasewachtwoorden in (paragraaf Voltooi de Windows-installatie). Begin vervolgens in de uitgepakte map scripts\start-app-windows.cmd en geopend http://localhost:8082.

De ZIP-installatie stelt ACEvo in. De officiële Dedicated Server en Java moeten vooraf worden geïnstalleerd.

Linux: Debian webinstallatieprogramma

De automatische manier is bedoeld voor Debian. Open een terminal, download het script en voer het blok uit. Er verschijnen geen tekens of asterisken bij het typen van wachtwoorden; typ toch en druk op enter. Sudo kan vervolgens om het wachtwoord van uw Linux-account vragen.

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 "Steam-accountnaam: " STEAM_LOGIN
  read -rp "H2-databasegebruiker: " DB_USER
  read -rsp "H2-databasewachtwoord: " DB_PASSWORD
  printf '\n'
  read -rsp "ACEvo-beheerderswachtwoord: " 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
)

Ingangen: Steam accountnaam, H2 gebruiker, H2 aangepast wachtwoord en ACEvo aangepast beheerderswachtwoord. SteamCMD vraagt het wachtwoord van Steam op en, indien nodig, Steam Guard zelf. Voer nooit uw Steam-wachtwoord in de opdracht in. H2-referenties zijn geen MariaDB-referenties en het H2-wachtwoord codeert het databasebestand niet.

Voordat u begint, kunt u de webpoort, installatiemap, gameservermap, configuratiemap en servicegebruiker in het blok wijzigen. Gebruik absolute Linux-paden zonder spaties. Het installatieprogramma voegt Debian-opslagplaatsen toe, installeert Java, SteamCMD en Wine, downloadt ACEvo en de spelserver, en stelt systemd in. Er worden geen routerpoorten geopend. Niet op Ubuntu of anderen Gebruik distributies. Als de configuratie of service ACEvo aanwezig is, wordt het script afgebroken.

Na een succesvolle uitvoering controleert het script de service en lokale webtoegang. Open http://localhost:8082 op de server of http://SERVER-IP:8082 uit het lokale netwerk. Vervangen SERVER-IP via het lokale IP-adres. Wanneer u voor de eerste keer inlogt als beheerder, gebruikt u het wachtwoord dat u eerder hebt gekozen. Er is geen beheerdersgebruikersnaam.

Bekijk het Linux-installatiescript

http://localhost:8082 op de computer zelf of http://SERVER-IP:8082 openen in het lokale netwerk. Verdere instellingen zijn beschikbaar in de secties Windows En Linux.

3. Voltooi de installatie van Windows

Bereid Steam en Dedicated Server voor

Installeer Steam en log in met een account dat toegang heeft tot Assetto Corsa EVO. Installeer vervolgens het hulpprogramma Assetto Corsa EVO Dedicated Server.

Een typisch Steam-pad is slechts een voorbeeld. Het gaat erom in welke map AssettoCorsaEVOServer.exe liegt eigenlijk.

Pak ACEvo uit in een vaste map

Voorbeeld: C:\ACEvo. Voor permanent gebruik dient u download- of tijdelijke mappen te vermijden.

Stel beheerderstoegang in vóór de eerste start

Maak de submap in de map ACEvo config. Open de editor, kopieer de volgende configuratie erin en vervang beide voorbeeldwachtwoorden door uw eigen waarden. Sla het bestand op als C:\ACEvo\config\application.properties; Selecteer “Alle bestanden” in het dialoogvenster voor opslaan, zodat Windows niet onopgemerkt blijft .txt bijgevoegd. Het bestand bevat wachtwoorden en mag niet worden gedeeld of openbaar geüpload.

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

De fallback wordt bij de eerste succesvolle aanmelding opgeslagen als het webbeheerderswachtwoord. Het bestand bevat geheimen. Bij het inloggen wordt alleen om een wachtwoord gevraagd, niet om een gebruikersnaam.

Eerste begin

Dubbelklik scripts\start-app-windows.cmd. Als Windows een firewallquery weergeeft, sta dan in eerste instantie alleen particuliere netwerken toe.

Open het dan http://localhost:8082.

Welke waarden moet je veranderen?

Waarde	invoer	Kennisgeving
`server.port`	Normaal gesproken `8082`	Wijzig alleen als poort 8082 al in gebruik is.
`acevo.paths.data-dir`	Beschrijfbare map, b.v. B. `C:/ACEvo`	Voorwaartse schuine strepen voorkomen ontsnappingsproblemen.
`spring.datasource.password`	Eigen lokaal wachtwoord	Gebruik geen algemeen bekend voorbeeldwachtwoord.
Speciaal serverpad	In de ACEvo-interface is de map met `AssettoCorsaEVOServer.exe` kiezen	Niet de EXE zelf, maar selecteer de juiste map.

4. Linux installatie en pre-configuratie van de beheerder

Op Debian is het webinstallatieprogramma het aanbevolen installatiepad. Hij stelt ACEvo en de officiële Dedicated Server in. Het serverbestand is Windows-EXE; Wine en Xvfb draaien op Linux zonder desktop.

Systeemvereisten: Debian, internettoegang en een gebruiker die sudo mag gebruiken. Voer dit script niet uit op Ubuntu of een andere distributie. Het is een expliciete aanvulling op de pakketbronnen van Debian.

Waarden vóór installatie

Waarde	Plicht	Standaard en doel
`STEAM_LOGIN`	Ja	Steam-accountnaam met toegang tot de officiële Dedicated Server. U voert het wachtwoord Steam en Steam Guard rechtstreeks in SteamCMD in.
`DB_USER`	Ja	Gebruikers van de lokale H2-bestandsdatabase bijvoorbeeld `acevo`. Dit is geen MariaDB-account.
`DB_PASSWORD`	Ja	Eigen wachtwoord voor toegang tot de database H2. Het codeert het databasebestand op schijf niet automatisch.
`GUI_ADMIN_PASSWORD`	Ja	Eigen wachtwoord voor de eerste ACEvo webbeheerder login. Er wordt geen beheerdersgebruikersnaam gebruikt.
`ACEVO_PORT`	Nee	Webpoort, standaard `8082`.
`ACEVO_HOME`	Nee	App-, data- en logomappen, standaard `/opt/acevo`.
`ACE_SERVER_HOME`	Nee	Map voor gameserver, standaard `/opt/ace-server`.
`ACEVO_CONFIG_DIR`	Nee	Beschermde configuratiemap, standaard `/etc/acevo`.
`ACEVO_SERVICE_USER`	Nee	Linux systeemaccount waaronder ACEvo draait; standaard `acevo`.
`DOWNLOAD_URL`	Nee	Downloadadres van het ACEvo JAR-bestand. Behoud de officiële standaardwaarde.

U kunt het optionele pad, de poort en de gebruikerswaarden aanpassen in het snelle installatieblok. Gebruik absolute paden zonder spaties. Het script slaat het database- en beheerderswachtwoord op /etc/acevo/install.env met beperkte rechten; de service systemd leest ze.

Wat het script automatisch doet

Het vormt een aanvulling op de pakketbronnen van Debian en installeert Java 21, SteamCMD, Wine, Xvfb en hulpprogramma's.
SteamCMD downloadt de officiële Dedicated Server met uw Steam-account.
Het script maakt zijn eigen Linux-servicegebruiker, de programma-, configuratie-, gegevens- en logomappen, en het voorvoegsel Wine.
Het laadt het ACEvo JAR-bestand van de officiële website en creëert een externe configuratie met poort, H2-database, gameserverpad en admin fallback.
Het stelt de service systemd in, maakt automatisch opstarten mogelijk en start ACEvo.
Ten slotte controleert het spelserverbestanden en de lokale webpoort.

Het installeert geen MariaDB, opent geen firewall- of routerpoorten en configureert geen gameserverinstantie. Een bestaande ACEvo-configuratie of -service zorgt ervoor dat het installatieprogramma om veiligheidsredenen wordt afgebroken. Als u een bestaande installatie heeft, maak dan eerst een back-up /opt/acevo/data En /etc/acevo.

Controleer de installatie en vind fouten

De terminal moet de service als actief melden en een HTTP-antwoord retourneren. U kunt deze opdrachten op elk gewenst moment opnieuw uitvoeren:

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

Vervangen 8082, als u een andere webpoort heeft gekozen. Als er een fout optreedt, lees dan eerst de berichten in het servicelogboek. Veelvoorkomende oorzaken zijn onder meer een gebrek aan toegang tot Steam, een onjuiste Steam Guard-procedure, bezette poorten of onvoldoende vrij geheugen.

Beheer- en gameservergegevens na lancering

Log in met het ACEvo beheerderswachtwoord dat u eerder hebt ingesteld. Wijzig dit indien mogelijk in de configuratie ACEvo. Als u de externe fallback niet permanent wilt accepteren, verwijdert u de regel acevo.security.gui-admin-password-fallback uit /etc/acevo/application.properties en start de service opnieuw. U kunt later de naam van de gameserver, het beheerderswachtwoord van de gameserver, de route en racesessies per instantie instellen in ACEvo; het Linux-installatieprogramma accepteert deze waarden niet.

Als u Debian niet gebruikt

Start het webinstallatieprogramma niet. De launcher-zip bevat het programma ACEvo en voorbeeldconfiguraties, maar stelt niet automatisch SteamCMD, Wine, machtigingen en een Systemd-service in. Voor andere Linux-distributies moet een beheerder de juiste pakketten instellen en systemd zelf opstarten.

5. Docker-installatie

Belangrijk: De onderzochte broncode-ZIP bevat geen Compose- of Docker-bestanden. De huidige website beschrijft hiervoor een apart pakket Docker. Gebruik deze sectie alleen in combinatie met de gepubliceerde release Docker, die compose.yaml, compose.local-mariadb.yaml, Dockerfile.local en bevat voorbeeldconfiguraties.

De ZIP bevat het vooraf gebouwde bestand acevo-server.jar in de hoofdmap. Het Docker-bestand wacht op u op target/acevo-server-1.0.0-SNAPSHOT.jar. Kopieer het daar voordat u begint. In PowerShell:

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

In bash gebruik je mkdir -p target En cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. De Docker ZIP bevat geen Maven-project. Gebruiken op Windows scripts/docker-up.ps1 -NoBuild of start Docker Direct opstellen docker compose up -d --build.

Pak het Docker-pakket uit

Controleer of in ieder geval deze bestanden aanwezig zijn:

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

Kopieer voorbeeldbestanden

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

Alle waarden inbegrepen CHANGE_ME vervanging.

Mount speciale servermap

Het bestand compose.local-mariadb.yaml bevat een voorbeeldpad van een ontwikkelaarsinstallatie. Vervang het door de daadwerkelijke hostmap met AssettoCorsaEVOServer.exe. Het Docker-pakket start alleen de webapp en stelt de Dedicated Server niet in.

Begin container

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

Test: docker compose -p acevo_local ps toont lopende containers. Open het dan http://localhost:8082.

Vereiste invoer

Waarde	Betekenis
MariaDB databasenaam	Bijvoorbeeld `acevo`; moet hetzelfde zijn in de app- en DB-configuratie.
MariaDB-gebruiker	Eigen gebruiker, niet blind `root` gebruik.
MariaDB-wachtwoord	Lang, uniek wachtwoord; identiek in beide configuraties.
Beheerderswachtwoord	Eigen wachtwoord voor de ACEvo beheerderstoegang.
Hostpad Dedicated Server	Absoluut pad naar de map met `AssettoCorsaEVOServer.exe`.
Webpoort	Standaard `8082`, tenzij anders in kaart gebracht.

6. Maak de eerste server in ACEvo

Beveiligde beheerderstoegang

De webbeheerder gebruikt slechts één wachtwoord. U kunt dit wijzigen in de ACEvo-configuratie. Ook een externe fallback die is ingesteld blijft geldig: verwijder deze pas na het opslaan van een nieuw wachtwoord en start daarna ACEvo opnieuw op.

Wijzig onmiddellijk een bestaand standaard- of reservewachtwoord. Gebruik geen wachtwoord uit een voorbeeldconfiguratie.

Selecteer een speciale servermap

Selecteer de map waarin AssettoCorsaEVOServer.exe, cars.json, events_practice.json En events_race_weekend.json liggen.

Poorten invoeren

In eerste instantie zijn de volgende gebieden in de sjabloon opgenomen:

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

Voor elke volgende instantie moeten de spelserverpoorten uniek zijn, b.v. Bijvoorbeeld 9701/9701/8092.

De ACEvo-webpoort 8082 staat er los van. Het installatieprogramma opent de firewall of router niet. Voor openbare gaming mag u alleen de spelserverpoorten vrijgeven die worden weergegeven in ACEvo, inclusief het TCP- of UDP-protocol. Stuur de webpoort niet rechtstreeks door naar internet; gebruik HTTPS met omgekeerde proxy.

Selecteer Installatie

Configureer route, modus, sessies, voertuigen, aantal spelers en weer. Volgens de geïntegreerde hulp betekent geen voertuigselectie: alle voertuigen zijn toegestaan.

Begin en controleer

Start de instance in ACEvo en controleer de status en log in.

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

7. Veelvoorkomende problemen

De website opent niet

Controleer de startconsole op fouten en of de poort correct is. De standaard is hier consistent 8082. Test http://localhost:8082.

“java” is niet gevonden

Java 21 is niet geïnstalleerd of niet in het PATH. Start na de installatie een nieuwe terminal en controleer java -version.

De Dedicated Server start niet

Controleer de map en bestanden. Onder Linux bovendien Wine, Xvfb, rechten en de logomap ACEvo.

Haven al bezet

Ofwel veranderen server.port voor ACEvo of de poorten van de betrokken gameserverinstantie. Elke instantie vereist unieke poorten.

Server is lokaal geopend, maar niet zichtbaar in het spel

Als TCP/UDP lokaal luistert, kan de oorzaak buiten ACEvo liggen, zoals een firewall, het delen van een router of een verbinding met de backend van het spel. Open poorten niet over de hele linie, maar alleen specifiek.

8. Na installatie

Stop ACEvo voordat u de bestandsdatabase H2 kopieert. Beveilig gegevens en configuratie afzonderlijk:

Windows: de map acevo.paths.data-dir En config\application.properties.
Debian: /opt/acevo/data, /etc/acevo/application.properties en het vertrouwelijke dossier /etc/acevo/install.env.
Docker: de permanente gegevensmap en de echte configuratiebestanden. Verwijder geen databasevolumes.

Back-upBeveilig gegevensmappen, configuratie en – met MariaDB – de database regelmatig.

UpdatesMaak een back-up vóór updates, lees de release-opmerkingen en bekijk configuratiewijzigingen.

Publieke werkingHTTPS, stel een reverse proxy, firewall, sterke wachtwoorden en een passend privacybeleid in.

ACEvo downloaden Naar de landingspagina

Als iets niet start

Controleer Java, het startlogboek, het serverpad en de ingestelde poort. Wijzig bij een bezette poort server.port en gebruik dezelfde poort in de browser. De ingebouwde H2-database volstaat om te beginnen.

Gratis downloaden ?E-mail sturen