FiveM Docker Setup: FXServer Compose, Ports & txAdmin

Checklist rapida per configurazione Docker FiveM

Una configurazione Docker utile mantiene i dati di txAdmin persistenti, espone le porte giuste e rende gli aggiornamenti reversibili.

Usa Docker Compose v2 e monta txData o la directory dei dati del server.
Esponi 30120 TCP/UDP per FiveM e 40120 solo dove è previsto l'accesso a txAdmin.
Fai backup di server.cfg, risorse, txData e dati del database prima di cambiare artefatti o immagini.

Percorsi correlati nello shop: Pacchetti server | FiveM Scripts | Strumenti di amministrazione

Run a FiveM server (FXServer) in Docker with this copy-paste guide: a minimal compose.yaml utilizzando spritsail/fivem image, correct port mapping for 30120 (TCP+UDP) and 40120 (txAdmin), persistent bind mounts for server.cfg, resources, and txAdmin data, license-key handling, and safe update and rollback steps.

In breve

Installa Docker Engine + Docker Compose v2 su Ubuntu. (Documentazione Docker)
Crea una cart progetti, aggiungi .env (imposta LICENSE_KEY, SERVER_NAME, porte) e un minimo compose.yaml.
Inizia con docker compose up -d; guarda i log con docker compose logs -f.
Modificare data/server.cfg (hostname, endpoint, risorse); riavvia il contenitore.
Apri il firewall per 30120/TCP+UDP E 40120/TCP (txAdmin). La porta predefinita di txAdmin è 40120. (Documenti Cfx.re)
Eseguire sempre il container con stdin/tty abilitato per evitare crash. (GitHub)

File Docker (Github)

Prerequisiti

Sistema operativo: Linux Ubuntu 22.04+ (note per macOS/Windows sotto).
Hardware: 2+ vCPU, 4–8 GB RAM (di più per risorse pesanti), SSD ra recommandato.
Docker: Installa Docker Engine E Compose v2 dalla documentazione ufficiale. (Documentazione Docker)
Chiave licenza FiveM: Generala nel portale Cfx.re (Keymaster). Tienila segreta. (supporto.cfx.re)
Firewall/NAT: Capacità di aprire/forwardare le porte 30120 (TCP+UDP) e opzionalmente 40120 (TCP). (Documenti Cfx.re)
(Opzionale) Un dominio/sottodominio per txAdmin.

Panoramica dell'architettura

Un contenitore esegue Server FX utilizzando spritsail/fivem immagine. I dati vengono bind-mounted persistere server.cfg, risorse e log. Le porte 30120/TCP+UDP sono esposte ai giocatori; 40120/TCP espone txAdmin quando abilitato. Un healthcheck può sondare http://127.0.0.1:30120/info.json. (GitHub)

+-------------------- Docker Host (Ubuntu) --------------------+
| /home/fivem/data --> /config (in container) |
| /home/fivem/txData --> /txData (txAdmin data) |
| |
| Exposed: 30120/tcp+udp [FXServer] | 40120/tcp [txAdmin] |
| Healthcheck: GET 127.0.0.1:30120/info.json |
+-------------------------------------------------------------+

Avvio rapido (copia-incolla)

1) Crea una cartella di progetto

# Optional: dedicated system user and directories
sudo useradd -r -m -d /home/fivem -s /usr/sbin/nologin fivem || true
sudo mkdir -p /home/fivem/{data,txData}
sudo chown -R "$USER":"$USER" /home/fivem
cd /home/fivem

2) Crea `.env`

cat > .env <<'EOF'
# === REQUIRED ===
LICENSE_KEY=REPLACE_WITH_YOUR_CFX_KEY

# Convenience (used by ports mapping below)
FXSERVER_PORT=30120
TXADMIN_PORT=40120

# Not read by the image directly; use it when editing server.cfg
SERVER_NAME="My Docker FiveM"

# Optional: if omitted, default config generation sets a random RCON password
RCON_PASSWORD=
EOF

3) Minimo `compose.yaml` (fissa un tag)

Configurazione minima funzion utilizando l'immagine upstream. Usa tty+stdin per prevenire crash. (GitHub)

# compose.yaml
services:
 fivem:
 image: spritsail/fivem:stable
 container_name: fivem
 environment:
 - LICENSE_KEY=${LICENSE_KEY}
 # Optional toggles (see table below):
 # - NO_DEFAULT_CONFIG=1 # required if you want to use txAdmin
 # - NO_LICENSE_KEY=1 # if you put the key in server.cfg instead
 # - NO_ONESYNC=1 # disable OneSync in default config
 # - RCON_PASSWORD=${RCON_PASSWORD}
 volumes:
 - ./data:/config # server.cfg, resources, logs
 ports:
 - "${FXSERVER_PORT}:30120/tcp"
 - "${FXSERVER_PORT}:30120/udp"
 tty: true # prevent startup crash (equiv. to -t)
 stdin_open: true # prevent startup crash (equiv. to -i)
 restart: unless-stopped

Avvia:

docker compose up -d
docker compose logs -f

4) Variante estesa (txAdmin, healthcheck, limiti)

# compose.extended.yaml
services:
 fivem:
 image: spritsail/fivem:stable
 container_name: fivem
 environment:
 - LICENSE_KEY=${LICENSE_KEY}
 - NO_DEFAULT_CONFIG=1 # enable txAdmin (no default +exec)
 # - NO_LICENSE_KEY=1 # if storing key in server.cfg
 # - RCON_PASSWORD=${RCON_PASSWORD}
 volumes:
 - ./data:/config
 - ./txData:/txData # persist txAdmin data
 ports:
 - "${FXSERVER_PORT}:30120/tcp"
 - "${FXSERVER_PORT}:30120/udp"
 - "${TXADMIN_PORT}:40120/tcp" # txAdmin Web UI (default 40120)
 tty: true
 stdin_open: true
 healthcheck:
 test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:30120/info.json >/dev/null 2>&1"]
 interval: 30s
 timeout: 5s
 retries: 5
 start_period: 30s
 # Basic resource knobs for standalone Compose (not Swarm 'deploy')
 cpus: 2
 mem_limit: "6g"
 ulimits:
 nofile:
 soft: 1048576
 hard: 1048576
 restart: unless-stopped

Se wget non è disponibile nell'immagine, rimuovi il healthcheck o sostituiscilo con una sonda TCP. txAdmin persiste sotto /txData, porta 40120 è il suo default. (GitHub)

Configurazione e persistenza

Al primo avvio, i default vengono scritti nel bind mount ./data (percorso del container /config). Modifica ./data/server.cfg e riavvia il container. (GitHub)

Tipico server.cfg bit:

# data/server.cfg
# Network endpoints (leave 0.0.0.0 to listen on all interfaces)
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Server name
set sv_hostname "My Docker FiveM"

# License key (use this only if NOT using LICENSE_KEY env)
# sv_licenseKey "REPLACE_WITH_YOUR_CFX_KEY"

# Example: ensure a basic resource
# ensure chat

Layout della directory (host):

/home/fivem
├─ data/ -> /config (server.cfg, resources/, logs/)
└─ txData/ -> /txData (txAdmin profiles & DB)

Backup

Backup del bind mount:

tar -C /home/fivem -czf fivem-backup_$(date +%F).tgz data txData

Se si passa a named volumes, esegui il backup così:

docker run --rm -v fivem_data:/data -v "$PWD":/backup busybox 
 sh -c 'tar -czf /backup/fivem_data_$(date +%F).tgz -C / data'

Variabili d'ambiente (da `spritsail/fivem`)

Nome	Scopo	Esempio
`LICENSE_KEY`	Necessario Chiave di licenza del server FiveM per avviare FXServer	`LICENSE_KEY=xxxxx`
`RCON_PASSWORD`	Password RCON usata quando si creano configurazioni predefinite; casuale di 16 caratteri se non impostata	`RCON_PASSWORD=strongpass`
`NO_DEFAULT_CONFIG`	Disabilita il default `+exec` così txAdmin può gestire il server	`1`
`NO_LICENSE_KEY`	Non leggere la chiave dall'ambiente; conservala in `server.cfg`	`1`
`NO_ONESYNC`	Disabilita OneSync nelle configurazioni predefinite	`1`

Queste variabili d'ambiente e percorsi /config, /txData, oltre alla necessità di -ti sono definiti dall'immagine upstream. (GitHub)

Segreto gestione: Preferisci NO_LICENSE_KEY=1 e metti sv_licenseKey In server.cfg con i permessi dei file corretti se non vuoi la chiave nell'env del contenitore. (GitHub)

Rete & Sicurezza

Porte richieste

Scopo	Porta	Proto
Connessioni giocatori / API	30120	TCP+UDP
txAdmin Web UI (opzionale)	40120	TCP
Legacy master (raramente necessario)	30110	UDP

FiveM utilizza come predefinita la 30120; il default di txAdmin è 40120. (GitHub)

Esempi di UFW (Ubuntu)

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow 40120/tcp # only if you enable txAdmin
sudo ufw reload

nftables (esempio di set di regole)

sudo nft add table inet filter
sudo nft add chain inet filter input '{ type filter hook input priority 0; policy drop; }'
sudo nft add rule inet filter input ct state established,related accept
sudo nft add rule inet filter input iif lo accept
sudo nft add rule inet filter input tcp dport {30120,40120} accept
sudo nft add rule inet filter input udp dport 30120 accept

Minimo privilegio & segreti

Esegui su un host rafforzato; evita di mappare capacità extra; non eseguire Docker come root utente sull'host.
Mantenere RCON abilitato solo se necessario; proteggi txAdmin con credenziali forti e limita l'accesso al firewall.
Se usi distribuzioni basate su SELinux (non Ubuntu), aggiungi :Z/:z ai bind mount per risolvere problemi di contesto.

Aggiornamenti & Rollback

Aggiorna all'ultimo tag fissato

docker compose pull
docker compose up -d

Blocca per digest (immutabile)

# Pull and discover the digest of the current tag
docker pull spritsail/fivem:stable
docker inspect --format='{{index .RepoDigests 0}}' spritsail/fivem:stable
# Use the printed value in compose, e.g.:
# image: spritsail/fivem@sha256:abcdef...

Rollback

Cambia il riferimento dell'immagine al tag/digest precedente e docker compose up -d.
Mantieni i digest recenti delle immagini con docker image ls --digests.

L'immagine fornisce stable E latest tag; preferisci stable per meno sorprese. (GitHub)

Monitoraggio & Manutenzione

Stato: docker ps, docker compose ps
Registri: docker compose logs -f
Statistiche: docker stats fivem
Healthcheck: Sondaggi info.json; rimuovi/adatta se mancano strumenti. (Documenti Cfx.re)
Disco: docker system df, elimina le vecchie immagini se necessario.
Backup: Pianifica il comando tar con Cron in “Configuration & Persistence”.

Risoluzione dei problemi

Chiave di licenza non valida: Verifica nel portale Cfx.re e assicurati che solo un server stia usando la chiave. (supporto.cfx.re)
Porte già in uso: sudo ss -lntup | grep 30120; ferma il servizio in conflitto o cambia FXSERVER_PORT.
Impossibile raggiungere txAdmin: Aprire 40120/TCP o cambia porta; conferma NO_DEFAULT_CONFIG=1. (Documenti Cfx.re)
Il container esce all'avvio: Garantire tty: true E stdin_open: true sono impostati. (GitHub)
Problemi di ora/DNS: Assicurati che l'ora dell'host sia sincronizzata (systemd-timesyncd/chrony) e che il DNS funzioni (/etc/resolv.conf).
Negazioni SELinux (non-Ubuntu): Utilizzo :Z/:z sui bind mounts o regola i contesti.
info.json/players.json bloccati: Alcune convars o proxy possono influenzare questi endpoint; conferma che il server risponda su GET /info.json. (Documenti Cfx.re)

Suggerimenti per le prestazioni

CPU/Memoria: Blocca le CPU e imposta i limiti di memoria (vedi compose esteso).
Magazzinaggio: Usa SSD/NVMe; mantieni i resource pack ottimizzati; evita asset enormi e non compressi.
Networking: Mantieni la latenza bassa; assicurati che l'host non sia throttlato dalla CPU; dai priorità a UDP 30120.
Kernel dell'host: I valori predefiniti ragionevoli funzionano; sysctl avanzati (net.core.*mem_max) possono essere regolati se conosci il tuo carico di lavoro.
Registri: Usa la rotazione dei log (come nell'esempio esteso).

Note su macOS/Windows

macOS (Docker Desktop): L'I/O dei file montati tramite bind è più lento rispetto al nativo Linux; considera le Condivisioni file sincronizzate per prestazioni migliori e assicurati che la cartella sia condivisa nelle impostazioni. (Documentazione Docker)
Windows (WSL2): Le porte pubblicate sono raggiungibili tramite host locale su Windows; l'esposizione alla LAN può richiedere configurazioni aggiuntive a seconda della modalità. Preferisci l'hosting su Linux per server pubblici. (Documentazione Docker)

Disinstallazione pulita

# Stop and remove the container (keep data)
docker compose down

# Remove container + anonymous networks + images (keeps bind-mounted data)
docker compose down --rmi local --remove-orphans

# If you used named volumes (not in this guide), list and remove explicitly:
# docker volume ls
# docker volume rm <volume_name>

Per eliminare Tutto i dati, rimuovi le directory montate tramite bind:

sudo rm -rf /home/fivem/data /home/fivem/txData

Domande frequenti

Posso ospitare più server su un unico host?
Sì. Usa directory di progetto separate, diverse FXSERVER_PORT/TXADMIN_PORT, e mount bind distinti. txAdmin supporta dati per profilo in /txData. (Documenti Cfx.re)

Come cambio il nome/IP del server mostrato nell'elenco?
Modificare sv_hostname In data/server.cfg. L'IP/porta proviene dalle porte pubblicate e dalla configurazione NAT.

Posso riavviare automaticamente in caso di crash?
SÌ. restart: unless-stopped in Compose; considera anche i timer systemd per i watchdog.

Dove si trovano i backup?
Dove li crei, ad esempio fivem-backup_YYYY-MM-DD.tgz nella tua directory di lavoro. Vedi i comandi di backup sopra.

Come abilito txAdmin?
Impostato NO_DEFAULT_CONFIG=1, monta tramite bind /txDatae apri 40120/TCP. (GitHub)

Devo aprire la porta 30110?
Raramente. Era usata per elenchi legacy; le configurazioni moderne tipicamente necessitano solo della 30120 e della 40120 di txAdmin se usata. (Comunità Cfx.re)

Come sposto il server su un'altra macchina?
Copia data/ E txData/ al nuovo host, ricrea lo stesso file Compose e avvia.

Link & Crediti

Immagine upstream: spritsail/fivem (variabili d'ambiente, percorsi, utilizzo, note su txAdmin, -ti requisito). (GitHub)
Docker:
- Installa Docker Engine su Ubuntu. (Documentazione Docker)
- Installare Docker Compose v2 (plugin Linux). (Documentazione Docker)
- Condivisione di file locali con i container (volumi vs bind mounts). (Documentazione Docker)
Cfx.re / FiveM:
- Creare una chiave di registrazione del server (licenza). (supporto.cfx.re)
- Documentazione di txAdmin (porta predefinita 40120; percorso dati). (Documenti Cfx.re)
- Flusso proxy/connessione (/info.json). (Documenti Cfx.re)

Editorial review and source policy

The Docker guide distinguishes container restart policy from application recovery. Pin images, persist server data outside the writable container layer, protect secrets, and validate backup/restore on the exact compose definition.