Een FiveM-server op CasaOS draaien: handleiding voor Docker-installatie

Ja, een FiveM-server kan via Docker op een CasaOS-host draaien. Dat was het antwoord in de IceWhale Community-thread van september 2023: de oude gaming-pc van de gebruiker had al voldoende middelen voor CasaOS-workloads, en communityleden wezen erop dat FiveM's FXServer Linux-builds heeft en als aangepaste CasaOS-applicatie in een container kan draaien.

De historische thread gebruikte de externe spritsail/fivem image en stelde zowel de FiveM-gamepoort als txAdmin beschikbaar. Dat blijft een nuttig startpunt voor de architectuur, maar het mag niet worden verward met een officieel Cfx.re CasaOS-pakket. De huidige documentatie van Cfx.re ondersteunt Linux FXServer nog steeds, maar waarschuwt expliciet dat de Linux-server een serviceversie is en dat Windows over het algemeen betere compatibiliteits- en diagnostische ondersteuning krijgt. In 2026 zijn er ook Linux- en Docker-specifieke FiveM-problemen blijven opduiken, dus test het exacte serverartefact en de gamebuild die je van plan bent te gebruiken.

Wat de oorspronkelijke CasaOS-thread bevestigde

In het bronbericht werd gevraagd of een privé-FiveM-server kon draaien op een oude gaming-pc die al als CasaOS-server diende. Twee antwoorden gaven het nuttige antwoord:

FiveM/FXServer kan op Linux en in Docker draaien.
Een aangepaste CasaOS-applicatie kan de vereiste poorten beschikbaar maken en configuratie en gegevens persistent opslaan.
De server heeft nog steeds een geldige Cfx.re-licentiesleutel nodig.
De hardware moet toereikend zijn voor het aantal spelers, resources, scripts en de databasebelasting.

Het Docker Compose-startpunt van de community

In het antwoord uit 2023 werd een aangepaste CasaOS-appdefinitie voorgesteld op basis van de externe spritsail/fivem image:

services:
  fivem:
    image: spritsail/fivem
    restart: on-failure
    environment:
      LICENSE_KEY: YOUR_LICENSE_KEY
      NO_DEFAULT_CONFIG: 1
    ports:
      - "40120:40120"
      - "30120:30120"
      - "30120:30120/udp"
    volumes:
      - /DATA/AppData/fivem/config:/config
      - /DATA/AppData/fivem/data:/txData
    stdin_open: true
    tty: true

Dit is een historische, uit de bron afgeleide configuratie en geen door IceWhale onderhouden app-definitie. Bekijk de huidige documentatie van de image voordat je deze in een actief CasaOS-systeem importeert.

Welke poorten heeft FiveM nodig?

De communityconfiguratie maakte het volgende zichtbaar:

30120/TCP — belangrijkste FXServer-gameverkeer.
30120/UDP — belangrijkste FXServer UDP-verkeer.
40120/TCP — txAdmin-webinterface in de bronconfiguratie.

In de huidige txAdmin-documentatie van Cfx.re wordt poort 40120 nog steeds vermeld als de standaard-HTTP-poort van txAdmin. Bekijk de huidige txAdmin-documentatie.

Een Cfx.re-licentiesleutel aanmaken

De huidige Cfx.re-documentatie voor het instellen van servers vereist een serverlicentiesleutel voordat FXServer wordt gestart. Registreer de server via de huidige workflow van Cfx.re/Cfx Portal en houd de sleutel privé.

Officiële referentie: Een server instellen.

Commit de sleutel niet naar een openbare Git-repository en plak deze niet in schermafbeeldingen. CasaOS-omgevingsvariabelen zijn handig, maar iedereen met beheerdersrechten voor de Docker-configuratie kan ze mogelijk lezen.

Configuratie en txAdmin-gegevens persistent maken

De oorspronkelijke Compose-configuratie koppelde:

/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data   → /txData

Het principe is belangrijker dan die exacte paden: de serverconfiguratie en txAdmin-profielen moeten op persistente opslag van de host staan, zodat het opnieuw aanmaken van de container de serverstatus niet wist.

Maak een back-up van die mappen voordat u containerimages of serverartifacts wijzigt.

De huidige FiveM-documentatie beschouwt Linux nog steeds als een secundaire serverport

De huidige vanilla-installatiedocumentatie van Cfx.re bevat een belangrijke waarschuwing voor Linux: de Linux-versie van FXServer wordt als een courtesy-port aangeboden, omdat compatibiliteit met Linux-distributies en native diagnostische hulpmiddelen lastiger kan zijn. Er staat dat problemen waarschijnlijker op Windows worden opgelost.

Dit betekent niet dat Linux-servers onbruikbaar zijn. Het betekent dat een CasaOS-Dockerimplementatie een extra compatibiliteitslaag heeft in vergelijking met een normaal ondersteunde Windows-server.

Docker-specifieke FiveM-problemen bestaan ook in 2026 nog

Recente meldingen over CitizenFX-problemen laten zien dat een Linux-FXServer correct in Docker kan werken, terwijl specifieke afgedwongen game builds of Enhanced-artifacts nog steeds containerspecifieke fouten veroorzaken. Zo werd in een probleem uit 2026 een clientcrash gereproduceerd met sv_enforceGameBuild 3751 op Linux/Docker, terwijl dezelfde vanilla-container zonder die instelling wel werkte.

Daarom garanderen een werkende containerstart en een bereikbare txAdmin-pagina niet dat elke combinatie van FiveM-artifacts en resources stabiel is.

Hoeveel hardware hebt u nodig?

In het oorspronkelijke antwoord uit 2023 werden verouderde minimale desktopvereisten voor FiveM aangehaald. Die waarden vormen geen betrouwbare moderne formule voor het bepalen van de servercapaciteit. De belasting van een dedicated server hangt sterk af van:

aantal spelers;
aantal frameworks en resources;
kwaliteit van Lua-/JavaScript-/C#-scripts;
databasebelasting;
OneSync-configuratie;
aanvullende services zoals MariaDB/MySQL.

Voor een kleine privéserver kan een oude gaming-pc volstaan, maar de single-threadprestaties van de CPU en de beschikbare RAM-capaciteit zijn belangrijker dan simpelweg voldoen aan een historische minimumlijst.

Voor FiveM-frameworks kan een afzonderlijke database nodig zijn

Als je ESX, QBCore of een ander framework installeert, moet de FiveM-container mogelijk verbinding kunnen maken met een MariaDB/MySQL-container. Plaats beide services op een door de gebruiker gedefinieerd Docker-netwerk, zodat ze kunnen communiceren via een stabiele servicenaam in plaats van veranderende container-IP-adressen.

Bewaar de databasegegevens in een eigen permanente CasaOS-AppData-map en maak er onafhankelijk van de FXServer-bestanden een back-up van.

Test op het LAN voordat je de server openstelt voor internet

Begin met een lokale test:

Bevestig dat de FiveM-container actief blijft.
Open txAdmin op http://CASAOS_IP:40120 als de image de standaardpoort gebruikt.
Voltooi de txAdmin-configuratie.
Bevestig 30120/TCP en 30120/UDP zijn gekoppeld.
Maak vanaf een ander apparaat op het LAN verbinding.
Configureer router-/firewallregels pas na lokaal testen als spelers vanaf internet toegang nodig hebben.

Hosting via internet brengt extra beveiligingsverantwoordelijkheden met zich mee

Een openbare gameserver ontvangt ongevraagd internetverkeer. Houd CasaOS zelf, SSH, de Docker-API en databasepoorten privé. Stel alleen de poorten beschikbaar die FXServer/txAdmin nodig hebben en overweeg de toegang tot txAdmin te beperken in plaats van de beheerinterface breed open te laten staan.

Stel MariaDB/MySQL niet rechtstreeks bloot aan internet alleen omdat FiveM een database nodig heeft.

Checklist voor een FiveM-server op CasaOS

Controleer of de host voldoende CPU, RAM en opslagruimte heeft.
Maak een Cfx.re-serverlicentiesleutel aan.
Kies een onderhouden FiveM/FXServer-Docker-image of bouw de image zelf op basis van actuele artefacten.
Bewaar de configuratie en txData buiten de container.
Stel beschikbaar 30120/TCP en 30120/UDP.
Stel txAdmin alleen beschikbaar als dat nodig is.
Test lokaal voordat je openbare firewall-/NAT-regels configureert.
Maak een back-up van txData, resources, server.cfg en elke externe database.
Houd rekening met compatibiliteitsverschillen tussen Linux/Docker en Windows FXServer.

Veelgestelde vragen over FiveM op CasaOS

Kan FiveM op CasaOS draaien?

Ja. De brondiscussie leverde een werkende Docker-architectuur voor een aangepaste CasaOS-app. De containerimage zelf was van derden en geen officieel CasaOS-pakket.

Is spritsail/fivem een officiële Cfx.re-image?

Nee. Het is een Docker-image van derden waarnaar de community verwijst. Controleer de huidige onderhoudsstatus voordat je het gebruikt.

Welke poorten moet ik koppelen?

De gebruikte bronconfiguratie 30120/TCP, 30120/UDP, en 40120/TCP voor txAdmin.

Wordt Linux/Docker net zo goed ondersteund als Windows?

Niet precies. In de huidige Cfx.re-documentatie wordt Linux FXServer expliciet beschreven als een port die uit beleefdheid beschikbaar is gesteld, en wordt aangegeven dat Windows waarschijnlijker oplossingen voor compatibiliteitsproblemen ontvangt.