Aggiornato al 02 luglio 2026. Il gioco di ruolo su Grand Theft Auto V è diventato uno dei fenomeni più duraturi del gaming su PC, e in Italia la scena del GTA RP continua a crescere community dopo community. Alla base di tutto c’è FiveM, il framework di modding che permette di ospitare mondi persistenti con centinaia di giocatori. Aprire un server FiveM proprio, però, spaventa molti: build che cambiano ogni settimana, chiavi di licenza, database, framework roleplay e decine di guide contraddittorie che citano URL ormai morti.

Questa guida elimina la confusione. In 12 passi porti online un server FiveM vanilla in circa 30 minuti su una VPS Linux, poi lo trasformi in una base solida per il GTA RP con txAdmin, il framework ESX o QBCore, un database MariaDB e una configurazione di sicurezza degna della produzione. Ogni comando è testato, ogni numero di porta verificato sulla documentazione ufficiale, e per ogni errore comune trovi la causa reale e la soluzione. Niente numeri di build inventati, niente keymaster.fivem.net: solo il flusso di lavoro corretto per il 2026.

Che cos’è un server FiveM e perché è legale nel 2026

FiveM è una modifica multiplayer per la versione PC di GTA V, sviluppata dal collettivo Cfx.re. Sostituisce il multiplayer ufficiale (GTA Online) con server privati e personalizzabili, ciascuno capace di caricare script in Lua, mappe e interfacce proprie. È il motore che alimenta praticamente ogni server di GTA RP italiano che avrai visto su Twitch.

La domanda che tutti si pongono prima di iniziare è: «Ma è legale?». La risposta, dal 2023, è un sì netto. L’11 agosto 2023 Cfx.re è entrata ufficialmente a far parte di Rockstar Games, la casa che sviluppa GTA V. L’auto-hosting di un server FiveM non è più una zona grigia tollerata: è una pratica sanzionata dallo stesso publisher, come confermato dall’annuncio sul newswire ufficiale di Rockstar Games e sul forum Cfx.re.

Ci sono però due condizioni non negoziabili. La prima: chi ospita il server e ogni singolo giocatore che si collega devono possedere una copia legittima di GTA V per PC (Steam, Epic Games o Rockstar Games Launcher). Le copie piratate falliscono la verifica di Cfx.re e non entrano. La seconda: serve una chiave di licenza gratuita, che ottieni dal portale Cfx.re e che vedremo al Passo 3. Rispettate queste regole, gestire un server di gioco di ruolo è pienamente in linea con i termini di servizio, esattamente come lo è configurare un server dedicato Palworld o qualsiasi altro server di gioco self-hosted.

Un ultimo chiarimento sulla terminologia. «FiveM» è il client-mod che gli utenti installano; «FXServer» è il software del server che eseguirai tu; «txAdmin» è il pannello web di amministrazione incluso in FXServer. Gli «artifacts» sono i pacchetti scaricabili di FXServer. Tenere separati questi concetti evita metà degli errori dei principianti.

Prerequisiti: hardware, software e versioni per il server FiveM

Prima di aprire il terminale, mettiamo in chiaro cosa serve. FiveM non pubblica requisiti hardware rigidi come fanno altri giochi, perché il carico dipende quasi interamente dagli script che caricherai. C’è però una regola d’oro che poche guide spiegano: la logica di gioco di GTA V e FiveM è in gran parte a thread singolo. Questo significa che la frequenza per core conta molto più del numero di core. Una VPS pubblicizzata come «8 vCPU» a bassa frequenza rende peggio di una «4 vCPU» ad alta frequenza. Quando scegli il piano, guarda il clock del singolo core, non il totale.

ComponenteMinimo praticoConsigliato (RP con script)Note
CPU2 vCPU ad alta frequenza4 vCPU ad alta frequenza (3,5 GHz+)Il single-thread è il collo di bottiglia
RAM4 GB8–16 GBCresce con risorse e slot
Disco20 GB SSD40 GB+ NVMe SSDNVMe riduce i tempi di caricamento risorse
Sistema operativoUbuntu 22.04 LTSUbuntu 24.04 LTS / Debian 12x86-64; consigliato Linux per la produzione
Rete1 Gbit/s, IP dedicato1 Gbit/s, DDoS protectionIl RP è sensibile alla latenza
GTA VCopia legittima PCCopia legittima PCObbligatoria per host e giocatori
Requisiti pratici per un server FiveM di roleplay. I valori RAM/CPU sono raccomandazioni operative, non specifiche ufficiali.

Sul fronte software, ti serviranno solo strumenti standard: git, wget, xz-utils per estrarre gli artifacts e un database MariaDB 10.6+ (oppure MySQL 8) se userai un framework roleplay. Consiglio Ubuntu 22.04 o 24.04 LTS: la documentazione FiveM è tarata su Debian/Ubuntu e la maggior parte degli script della community assume questo ambiente. Windows Server funziona, ma su Linux ottieni prestazioni migliori, un footprint più leggero e la gestione via systemd che vedremo al Passo 12.

Nota importante sulle porte, che anticipiamo perché è fonte del 50% dei problemi di connessione: il server FiveM usa la porta 30120 in TCP e UDP per il traffico di gioco, mentre il pannello txAdmin gira sulla porta 40120. La prima va aperta sul firewall; la seconda non va mai esposta pubblicamente. Torneremo su questo punto al Passo 11.

Dove ospitare il server FiveM: VPS, dedicato o hosting gestito

Prima di scrivere il primo comando devi decidere dove vivrà il tuo server FiveM. È una scelta che condiziona costi, prestazioni e quanta responsabilità tecnica ti assumi. Le opzioni concrete sono tre, e non esiste una risposta giusta per tutti: dipende dal tuo budget e da quanto vuoi imparare.

SoluzioneCosto indicativo/meseControlloCompetenze richiesteIdeale per
VPS (self-hosted)15–40 €Completo (root)Linux di baseLa maggior parte dei server RP
Server dedicato60–150 €Completo, hardware fisicoAmministrazione sistemiCommunity grandi, 128+ slot
Hosting FiveM gestito10–30 €Limitato (pannello)MinimaChi vuole partire in fretta
Home server (casa)Solo elettricitàCompletoRete e port forwardingSolo test, mai produzione
Confronto delle opzioni di hosting per un server FiveM di GTA RP.

Per la stragrande maggioranza dei progetti la scelta corretta è una VPS Linux: costo contenuto, controllo totale via SSH e la libertà di installare qualsiasi cosa. È l’ipotesi su cui è costruita questa guida. Il server dedicato ha senso solo quando la tua community supera stabilmente i cento giocatori simultanei e la CPU single-thread di una VPS non basta più. L’hosting FiveM gestito – pannelli come quelli offerti da vari provider specializzati – ti fa partire in cinque minuti senza toccare Linux, ma paghi in flessibilità: spesso non puoi installare pacchetti di sistema arbitrari né usare un tunnel SSH per txAdmin. L’home server, infine, va bene per imparare e testare, ma esporre la tua rete domestica e il tuo IP a Internet per un server pubblico è una pessima idea sotto ogni profilo di sicurezza.

Un consiglio sul provider: scegline uno con data center in Europa (idealmente in Italia, Germania o Francia) per ridurre la latenza verso i tuoi giocatori, e verifica che offra protezione DDoS. Ricordati sempre la regola del Passo sui prerequisiti: privilegia la frequenza per core rispetto al numero di core. A parità di prezzo, «4 vCPU a 3,8 GHz» batte «8 vCPU a 2,2 GHz» per un server FiveM.

Passo 1: Preparare la VPS e il sistema operativo

Collegati alla tua VPS via SSH come root o con un utente sudo. La prima cosa da fare, sempre, è aggiornare il sistema e installare le dipendenze. Su Ubuntu o Debian:

# Aggiorna il sistema
sudo apt update && sudo apt upgrade -y

# Installa gli strumenti necessari
sudo apt install -y git curl wget xz-utils screen ufw

# Verifica le versioni
git --version
wget --version | head -n 1

Non eseguire mai il server come root: è un rischio di sicurezza inutile. Creiamo un utente dedicato e non privilegiato, che isolerà i processi FiveM dal resto del sistema. Questa è la stessa logica di igiene che applicheresti gestendo le tue chiavi SSH o qualsiasi altro servizio esposto in rete.

# Crea un utente dedicato chiamato "fivem"
sudo useradd -m -s /bin/bash fivem

# Imposta una password
sudo passwd fivem

# Passa all'utente fivem per tutti i passi successivi
sudo su - fivem

# Prepara le cartelle: motore separato dai dati
mkdir -p ~/server ~/server-data

La separazione tra ~/server (il motore FXServer) e ~/server-data (configurazione, risorse e script) è deliberata e cruciale. Quando aggiornerai gli artifacts ogni settimana, sostituirai solo il contenuto di ~/server senza mai toccare la tua configurazione. È l’errore numero uno dei principianti: mettere tutto in una cartella e cancellare per sbaglio il proprio lavoro durante un aggiornamento.

Passo 2: Verificare la copia di GTA V e i client

Questo passo non richiede comandi, ma è quello che più spesso viene saltato con conseguenze frustranti. Il software di FXServer si scarica e si avvia senza possedere il gioco. Tuttavia, per collegarti al tuo stesso server ti serve una copia legittima di GTA V per PC, e lo stesso vale per ogni giocatore. Verifica quindi tre cose prima di proseguire:

  • Il tuo account Steam, Epic o Rockstar possiede GTA V (Grand Theft Auto V «Legacy» o «Enhanced»: entrambi vanno bene per FiveM).
  • Il client FiveM è installato sul PC con cui testerai (scaricabile dal sito ufficiale fivem.net, non da mirror di terze parti).
  • I tuoi futuri giocatori sanno che serve una copia legittima: le versioni piratate vengono bloccate dalla verifica Cfx.re e generano ticket di supporto infiniti.

Un dettaglio utile: FiveM è per GTA V, ma esiste anche RedM per Red Dead Redemption 2, che usa lo stesso ecosistema Cfx.re. Se un domani vorrai un server western, le competenze di questa guida si trasferiscono quasi integralmente. Per ora restiamo su GTA V, che è ciò che il pubblico italiano del GTA RP cerca.

Passo 3: Ottenere la chiave di licenza dal portale Cfx.re

Ogni server FiveM pubblico ha bisogno di una chiave di licenza gratuita. È qui che la maggior parte delle guide, comprese quelle generate dai motori di ricerca, ti fa perdere tempo: continuano a citare keymaster.fivem.net, un indirizzo ormai superato. Nel 2026 la chiave si genera dal portale Cfx.re.

  • Vai su portal.cfx.re e accedi con il tuo account Cfx.re (o creane uno gratuito).
  • Nella sezione delle chiavi server, genera una nuova license key.
  • Ti verrà chiesto l’indirizzo IP: se non hai un IP fisso, puoi lasciare il valore predefinito. La chiave resta valida.
  • Copia la chiave in un posto sicuro. La inseriremo nel server.cfg come sv_licenseKey.

Tratta questa chiave come una password: è segreta. Non condividerla mai, non pubblicarla su GitHub e non incollarla in un canale Discord pubblico. Cfx.re revoca le chiavi compromesse, e ritrovarsi il server offline nel bel mezzo di una serata di roleplay perché la chiave è finita in un repository pubblico è un classico evitabile. Se sospetti una fuga, rigenerala immediatamente dal portale.

FXServer viene distribuito come «artifacts»: pacchetti numerati nel formato NNNNN-hash che vengono aggiornati quasi ogni settimana. La pagina degli artifacts per Linux presenta due colonne, «Latest» e «Recommended». Scegli sempre la colonna Recommended: è la build stabile testata dal team Cfx.re. La colonna Latest contiene versioni sperimentali che possono rompere gli script della community.

La regola più importante di questo passo: non incollare mai un numero di build fisso preso da una guida. Quando leggi «scarica la build 12345», quel numero è già obsoleto. Vai sulla pagina ufficiale degli artifacts Linux, copia il link della riga Recommended e usa quello.

# Vai nella cartella del motore
cd ~/server

# Sostituisci l'URL con il link "Recommended" copiato dalla pagina ufficiale.
# Il formato è: .../master/NNNNN-hash/fx.tar.xz  (NON copiare questo numero!)
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/RECOMMENDED-hash/fx.tar.xz

# Estrai e pulisci
tar xf fx.tar.xz
rm fx.tar.xz

# Verifica che run.sh sia presente
ls -la run.sh

Se il comando ls mostra run.sh, il motore è pronto. Questo file è lo script di avvio che lancia FXServer e, con esso, txAdmin. La bellezza di questo modello è che aggiornare il server in futuro significa semplicemente scaricare un nuovo artifact Recommended in ~/server, senza toccare nulla in ~/server-data.

Passo 5: Clonare cfx-server-data e strutturare le cartelle

Il motore da solo non basta: serve un insieme minimo di risorse di base (gestione mappa, chat, spawn dei giocatori). Cfx.re fornisce esattamente questo in un repository ufficiale. Cloniamolo dentro la cartella dei dati che abbiamo creato al Passo 1.

# Torna nella home dell'utente fivem
cd ~

# Clona il repository ufficiale delle risorse di base
git clone https://github.com/citizenfx/cfx-server-data.git server-data

# Entra nella cartella
cd server-data
ls resources/

All’interno di resources/ trovi le risorse essenziali come mapmanager, chat, spawnmanager e sessionmanager. Questo repository ufficiale, disponibile su GitHub citizenfx/cfx-server-data, è il fondamento su cui costruirai. Le tue risorse personalizzate – script RP, mappe MLO, veicoli – andranno aggiunte qui dentro, in sottocartelle dedicate come [local] o [esx].

A questo punto la struttura del tuo server è chiara e pulita: ~/server contiene il motore FXServer aggiornabile, mentre ~/server-data contiene tutto ciò che è «tuo». È la separazione che ti salverà da innumerevoli mal di testa. Nel prossimo passo generiamo il file di configurazione e avviamo il pannello txAdmin per la prima volta.

Passo 6: Primo avvio e configurazione di txAdmin

txAdmin è il pannello di controllo web incluso in ogni artifact FXServer, sviluppato da Tabarra. Ti permette di gestire il server dal browser: avvii, riavvii, console live, gestione risorse, backup e persino un deployer di «recipe» che installa framework completi con un clic. Avviamolo.

# Dalla cartella del motore, avvia FXServer/txAdmin
cd ~/server
bash run.sh

Al primo avvio, il terminale mostrerà un output simile a questo, con un PIN temporaneo:

[txAdmin] Starting txAdmin version 7.x.x
[txAdmin] Web server is now listening on port 40120!
[txAdmin] To complete the setup, open one of the URLs below:
          http://localhost:40120/
[txAdmin] Use the PIN below to register:  3948

Ora apri il pannello nel browser. Poiché la porta 40120 non deve essere esposta a Internet (vedi Passo 11), il modo corretto per raggiungerla è un tunnel SSH dal tuo PC:

# Sul TUO computer (non sulla VPS), crea il tunnel:
ssh -L 40120:localhost:40120 fivem@IP_DEL_SERVER

# Poi apri nel browser:  http://localhost:40120

Nella procedura guidata di txAdmin: inserisci il PIN, collega il tuo account Cfx.re, imposta un nome utente e una password amministratore robusta, e infine scegli il deployer. Qui appare la scelta chiave: la recipe «CFX Default» crea un server vanilla funzionante all’istante, ideale per verificare che tutto giri prima di aggiungere complessità. Le recipe ESX e QBox installano invece un framework roleplay completo, ma richiedono un database già pronto. Il mio consiglio: parti da CFX Default, verifica di riuscire a entrare in gioco, poi passa al framework. La documentazione ufficiale di txAdmin sul sito FiveM descrive ogni schermata della procedura.

Passo 7: Il file server.cfg spiegato riga per riga

Il cuore di ogni server FiveM è server.cfg, nella cartella ~/server-data. txAdmin ne genera uno di base, ma capirlo riga per riga è ciò che distingue chi «segue una guida» da chi «gestisce un server». Ecco un server.cfg completo e commentato, pronto per un server RP italiano:

# ===== server.cfg - Server FiveM GTA RP Italia =====

# Endpoint di rete: porta 30120 in TCP e UDP (entrambe obbligatorie)
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Informazioni mostrate nel browser dei server
sv_hostname "Il Mio Server GTA RP Italia"
sets sv_projectName "GTA RP Italia"
sets sv_projectDesc "Server roleplay in italiano - community seria"
sets locale "it-IT"
sets tags "roleplay, italia, esx, serio"

# Numero massimo di giocatori. Usa una potenza di 2.
# Oltre 48 slot serve l'abbonamento Cfx.re Element Club.
sv_maxclients 48

# OneSync: OBBLIGATORIO oltre 32 slot
set onesync on

# Chiave di licenza da portal.cfx.re (SEGRETA!)
sv_licenseKey "LA_TUA_CHIAVE_CFX"

# Password RCON: usa una stringa lunga e casuale
rcon_password "PASSWORD_RCON_MOLTO_LUNGA"

# Stringa di connessione al database (letta da oxmysql)
set mysql_connection_string "mysql://fivem:PASSWORD_DB@localhost/fivem?charset=utf8mb4"

# --- Risorse di base ---
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure fivem
ensure hardcap
ensure rconlog

# --- Connettore database PRIMA del framework ---
ensure oxmysql

# --- Framework roleplay (esempio ESX) ---
ensure es_extended

# Aggiungi qui le tue risorse RP personalizzate...

Tre righe meritano attenzione particolare. endpoint_add_tcp e endpoint_add_udp devono puntare entrambe alla 30120: se ometti l’UDP, i giocatori restano bloccati su «Connecting». sv_maxclients deve essere una potenza di 2 e, come vedremo al Passo 10, oltre 32 slot richiede set onesync on. Infine, l’ordine degli ensure non è casuale: oxmysql deve sempre precedere il framework, altrimenti otterrai l’errore «no such export execute in resource oxmysql». Per l’elenco completo delle direttive puoi consultare la reference dei comandi server.

Passo 8: Scegliere il framework RP – ESX, QBCore o QBox

Un server vanilla ti fa girare per Los Santos, ma non è ancora roleplay. Servono i «framework»: strati di script che aggiungono lavori, economia, inventario, gestione dei personaggi. In italiano e nel resto d’Europa, la scelta si riduce a tre nomi.

FrameworkRepositoryMaturitàCurva di apprendimentoIdeale per
ESXesx-framework/esx_coreIl più diffuso e datatoMedia (moltissima documentazione)Principianti, community italiane
QBCoreqbcore-frameworkModerno e modulareMedia-altaChi vuole architettura pulita
QBoxQbox-project/qbx_coreFork mantenuto di QBCoreMedia-altaProgetti QB attivi nel 2026
Confronto dei tre principali framework roleplay per server FiveM nel 2026.

ESX, ospitato su GitHub esx-framework/esx_core, è il framework più usato al mondo e vanta il catalogo di script più ampio. Per chi inizia, e in particolare per le community italiane, è la scelta più sensata: qualunque problema tu incontri, qualcun altro l’ha già risolto e documentato. QBCore è più moderno e modulare, apprezzato da chi vuole un codice più ordinato. QBox, su GitHub Qbox-project/qbx_core, è un fork della community attivamente mantenuto di QBCore, ottimo se nel 2026 vuoi restare nell’ecosistema QB con manutenzione garantita.

Un avvertimento che risparmia settimane di debug: non mescolare script ESX e QBCore senza un «bridge». Gli script scritti per un framework assumono le sue export e i suoi eventi; installarne uno dell’altro ecosistema senza un livello di compatibilità produce errori a cascata. Scegli un framework e costruisci coerentemente attorno a esso. Il modo più rapido di installarlo è tramite la recipe del deployer txAdmin al Passo 6; in alternativa, cloni il repository dentro ~/server-data/resources e aggiungi la riga ensure in server.cfg.

Passo 9: Installare MariaDB e il connettore oxmysql

Qualsiasi framework roleplay ha bisogno di un database per salvare personaggi, denaro, inventari e proprietà. Lo standard de facto è MariaDB (versione 10.6 o superiore) oppure MySQL 8. Installiamolo e mettiamolo in sicurezza.

# Installa MariaDB
sudo apt install -y mariadb-server

# Avvia la procedura di hardening guidata
sudo mysql_secure_installation

# Accedi come root del database
sudo mysql -u root -p

Dentro la console MariaDB, crea il database e un utente dedicato. Nota il CHARACTER SET utf8mb4: è essenziale perché gli accenti italiani (à, è, ì) e gli emoji vengano salvati correttamente. Ometterlo è la causa dei famigerati «Ã©» che compaiono nei nomi dei personaggi.

CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'PASSWORD_DB_ROBUSTA';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Il connettore che permette a FiveM di dialogare con il database è oxmysql, mantenuto dal team Overextended e disponibile su GitHub overextended/oxmysql. Scaricalo nella cartella risorse, poi assicurati che in server.cfg la riga ensure oxmysql compaia prima di quella del framework. Questo ordine non è un dettaglio stilistico: se il framework parte prima che oxmysql abbia registrato le sue export, il server crasha con l’errore «no such export execute». La stringa di connessione, già vista al Passo 7, deve includere ?charset=utf8mb4 per coerenza con il database appena creato.

Passo 10: OneSync e il numero di slot giocatore

OneSync è la tecnologia di sincronizzazione lato server di FiveM: gestisce entità, giocatori e stato del mondo in modo autorevole, superando i limiti del vecchio modello peer-to-peer. È ciò che permette a un server FiveM di ospitare decine o centinaia di giocatori in uno stesso mondo persistente. La sua configurazione determina direttamente quanti slot puoi aprire.

ConfigurazioneSlot massimiDirettiva in server.cfgRequisito
OneSync disattivato32(nessuna)Nessuno
OneSync legacy64set onesync legacyGratuito
OneSync Infinity128–2048set onesync onCPU adeguata
Fino a 48 slot48set onesync onGratuito
Oltre 48 slot64+set onesync onCfx.re Element Club
Relazione tra configurazione OneSync, slot massimi e requisiti per il server FiveM.

I numeri chiave da ricordare: senza OneSync il limite è 32 giocatori; con OneSync Infinity (set onesync on) sali fino a un massimo teorico di 2048, anche se il tetto reale è imposto dalla CPU. FiveM è gratuito fino a 48 slot; per superarli serve un abbonamento Cfx.re Element Club Argentum o superiore. Ricorda anche che sv_maxclients dovrebbe essere una potenza di 2 (32, 64, 128). La documentazione tecnica completa è sulla pagina OneSync della reference FiveM.

Un consiglio pratico: non aprire 128 slot solo perché il file di configurazione te lo permette. Ogni giocatore aggiuntivo consuma CPU single-thread, e un server pieno con script pesanti può soffrire di lag anche su hardware costoso. Parti con un numero realistico per la tua community – 32 o 48 slot per un progetto nuovo – e cresci solo quando i numeri di gioco lo giustificano davvero.

Passo 11: Sicurezza – firewall UFW e tunnel SSH per txAdmin

Un server esposto a Internet senza firewall è un bersaglio. Configuriamo UFW aprendo solo ciò che serve. La regola d’oro: la porta 30120 va aperta, la porta 40120 di txAdmin non va mai esposta pubblicamente. Chiunque raggiunga il tuo pannello txAdmin può controllare l’intero server.

# Consenti SSH (adatta la porta se l'hai cambiata)
sudo ufw allow 22/tcp

# Apri la porta di gioco FiveM in TCP e UDP
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp

# Blocca esplicitamente il pannello txAdmin dall'esterno
sudo ufw deny 40120/tcp

# Attiva il firewall
sudo ufw enable
sudo ufw status verbose

Con la 40120 bloccata, come accedi a txAdmin? Tramite il tunnel SSH già visto al Passo 6: ssh -L 40120:localhost:40120 fivem@IP_DEL_SERVER, poi apri http://localhost:40120 sul tuo PC. Il traffico del pannello viaggia cifrato dentro SSH e non è mai raggiungibile da estranei. È lo stesso principio di difesa in profondità che applicheresti con un firewall di rete come pfSense o OPNsense: esporre la minima superficie possibile.

Per un ulteriore livello, installa fail2ban per proteggere SSH dagli attacchi a forza bruta, usa autenticazione a chiave pubblica invece della password, e mantieni sia il sistema sia gli artifacts sempre aggiornati. Se il tuo provider offre protezione DDoS di livello 4/7, attivala: i server di GTA RP di successo attirano puntualmente attacchi da parte di rivali o utenti bannati. La sicurezza non è un passo opzionale da rimandare, è parte integrante della configurazione.

Passo 12: Produzione con systemd per l’avvio automatico

Finché avvii il server con bash run.sh in un terminale, si spegne quando chiudi la sessione SSH. Per la produzione servono avvio automatico al riavvio della VPS e ripartenza in caso di crash. Su Linux, lo strumento è systemd. Crea il file /etc/systemd/system/fivem.service:

[Unit]
Description=FiveM FXServer (GTA RP)
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
Type=simple
User=fivem
Group=fivem
WorkingDirectory=/home/fivem/server-data
ExecStart=/home/fivem/server/run.sh +exec /home/fivem/server-data/server.cfg
Restart=on-failure
RestartSec=15
# SIGINT permette al server di salvare prima di chiudersi
KillSignal=SIGINT

[Install]
WantedBy=multi-user.target

Attiva il servizio con i comandi standard di systemd:

# Ricarica la configurazione di systemd
sudo systemctl daemon-reload

# Abilita l'avvio automatico al boot
sudo systemctl enable fivem

# Avvia subito il servizio
sudo systemctl start fivem

# Controlla lo stato e i log in tempo reale
sudo systemctl status fivem
sudo journalctl -u fivem -f

Una nota architetturale importante: scegli un solo supervisore. Se usi systemd per riavviare il processo, disattiva il riavvio automatico incorporato di txAdmin, altrimenti i due strumenti litigano e finisci con riavvii doppi o loop. In alternativa, molti amministratori lasciano che sia txAdmin a supervisionare il processo di gioco e usano systemd solo per tenere vivo txAdmin stesso. Entrambi gli approcci funzionano; ciò che non funziona è avere due supervisori che si contendono lo stesso processo. La guida ufficiale al setup del server FiveM approfondisce entrambe le strategie.

RGPD e privacy per un server GTA RP in Europa

Ecco l’aspetto che quasi nessuna guida tecnica affronta, ma che per un amministratore italiano o europeo è decisivo. Nel momento in cui il tuo server FiveM raccoglie dati dei giocatori – ID Discord, indirizzi IP, log delle azioni di gioco, identificatori Steam/Rockstar – stai trattando dati personali, e il GDPR (RGPD) si applica. Non è teoria: le sanzioni per trattamento illecito sono reali anche per progetti amatoriali di una certa dimensione.

Le buone pratiche non sono complicate, ma vanno rispettate. Pubblica un’informativa sulla privacy chiara sul tuo Discord o sito, che spieghi quali dati raccogli e perché. Conserva i log solo per il tempo necessario alla moderazione, poi cancellali. Cifra i backup del database e limita chi vi ha accesso. Offri agli utenti un modo per richiedere la cancellazione dei propri dati (il «diritto all’oblio»). Se ospiti il server tramite un provider fuori dall’UE, verifica le clausole sul trasferimento dati.

C’è poi il capitolo monetizzazione, dove privacy e regole Cfx.re si incrociano. La policy di Cfx.re vieta il pay-to-win: non puoi vendere vantaggi di gioco. Le donazioni sono permesse solo tramite il canale sanzionato, Tebex, che gestisce anche gli aspetti fiscali e di conformità dei pagamenti. Vendere «pacchetti VIP» che danno soldi o oggetti in-game viola i termini e può costarti la revoca della licenza. Un server serio tratta privacy e monetizzazione con la stessa cura che dedica al codice.

Ottimizzazione e prestazioni del server

Un server che parte non è un server che gira bene. Le prestazioni nel GTA RP si misurano in «server tick» e nella fluidità percepita dai giocatori, e il fattore dominante – lo ripetiamo perché è controintuitivo – è la performance single-thread della CPU. Prima di aggiungere hardware, ottimizza il software.

  • Usa il resource monitor di txAdmin (il comando resmon in console): identifica quali risorse consumano più tempo CPU per tick e intervieni su quelle.
  • Rimuovi gli script inutilizzati: ogni risorsa attiva costa, anche se nessuno la usa. Un server RP «pulito» con 60 risorse mirate rende meglio di uno con 300 script accumulati.
  • Evita i loop stretti: gli script mal scritti con while true do ... Citizen.Wait(0) end sono la causa numero uno di cali di tick. Preferisci script event-driven.
  • Aggiorna gli artifacts regolarmente alla build Recommended: le ottimizzazioni del motore arrivano gratis.
  • NVMe invece di HDD: i tempi di caricamento delle risorse all’avvio e lo streaming degli asset ne beneficiano sensibilmente.

Monitora costantemente. txAdmin mostra grafici di utilizzo che ti dicono in anticipo quando un aggiornamento di script ha peggiorato le prestazioni. Se noti che il server perde tick quando si riempie, il problema è quasi sempre uno script specifico, non la mancanza di RAM. Questo approccio diagnostico – misura, isola, correggi – è lo stesso che useresti per mettere in sicurezza qualsiasi sistema Linux dedicato al gaming.

Risoluzione dei problemi comuni del server FiveM

Anche seguendo ogni passo, prima o poi incontrerai un errore. Ecco gli otto problemi più frequenti su un server FiveM, con la causa reale e la soluzione, così eviti di perdere ore su forum contraddittori.

SintomoCausa probabileSoluzione
I giocatori restano su «Connecting» all’infinitoPorta UDP 30120 chiusa o endpoint UDP mancanteApri 30120/udp sul firewall e verifica endpoint_add_udp
«Invalid license key»Chiave errata, scaduta o revocataRigenera la chiave da portal.cfx.re e aggiorna sv_licenseKey
«no such export execute in resource oxmysql»oxmysql caricato dopo il frameworkSposta ensure oxmysql prima del framework in server.cfg
Accenti mostrati come «Ã©» o «Ã¨»Charset del database non utf8mb4Ricrea il DB con utf8mb4 e aggiungi ?charset=utf8mb4 alla connessione
Il server non compare nella server listOneSync/slot mal configurati o server dietro NATVerifica sv_maxclients, onesync e il port forwarding
«Connection refused» al databaseMariaDB non avviato o credenziali errateControlla systemctl status mariadb e la stringa di connessione
Il pannello txAdmin non è raggiungibilePorta 40120 correttamente bloccata dal firewallAccedi tramite tunnel SSH, non aprire mai la 40120
Version mismatch tra client e serverArtifact non aggiornato dopo un update del client FiveMScarica l’artifact Recommended più recente in ~/server
Otto problemi comuni di un server FiveM e le relative soluzioni.

Il metodo generale per il debug è sempre lo stesso: leggi la console. txAdmin mostra i log in tempo reale, e la maggior parte degli errori è esplicita se ti prendi il tempo di leggerla. Quando cerchi aiuto sul forum Cfx.re, incolla sempre il messaggio d’errore esatto: chiedere «non funziona» senza log riceve poche risposte.

Consigli avanzati e progetto completo

Una volta che il tuo server FiveM è stabile, questi accorgimenti lo rendono professionale. Il primo è un sistema di backup automatico del database: perdere il progresso di una community per un crash del disco è il modo più rapido di svuotare un server.

#!/bin/bash
# backup-fivem.sh - backup giornaliero del database FiveM
DATA=$(date +%Y-%m-%d_%H-%M)
DEST=/home/fivem/backups
mkdir -p "$DEST"

# Esporta il database (mysqldump legge le credenziali da ~/.my.cnf)
mysqldump fivem | gzip > "$DEST/fivem-$DATA.sql.gz"

# Conserva solo gli ultimi 7 giorni
find "$DEST" -name "fivem-*.sql.gz" -mtime +7 -delete

Rendi lo script eseguibile con chmod +x backup-fivem.sh e pianificalo con cron (crontab -e, riga 0 5 * * * /home/fivem/backup-fivem.sh per un backup ogni notte alle 5). Altri accorgimenti da server maturo:

  • Ambiente di staging: prova ogni nuovo script su un secondo server di test prima di metterlo in produzione. Non aggiornare mai «a caldo» su un server pieno di giocatori.
  • Riavvii programmati: txAdmin permette riavvii pianificati (es. ogni 6 ore) che liberano memoria e applicano aggiornamenti in modo ordinato, annunciandoli ai giocatori.
  • Versionamento della configurazione: tieni server.cfg e le risorse personalizzate in un repository Git privato, così puoi tornare indietro dopo una modifica sbagliata.
  • Separazione dei ruoli admin: in txAdmin crea account con permessi granulari per i moderatori, invece di condividere l’account amministratore.
  • Monitoraggio esterno: uno script di uptime che ti avvisa su Discord quando il server cade ti fa intervenire prima che se ne accorgano i giocatori.

Con il server.cfg del Passo 7, l’unità systemd del Passo 12 e questo script di backup, hai un progetto completo e riproducibile: dalla VPS nuda a un server di GTA RP pronto per la produzione, versionato e messo in sicurezza. È la differenza tra un server che dura una settimana e uno che costruisce una community.

Domande frequenti sul server FiveM

Quanto costa aprire un server FiveM?

Il software FiveM e la chiave di licenza sono gratuiti fino a 48 slot. Il costo reale è la VPS: per un server RP di piccole dimensioni si parte indicativamente da 15–30 € al mese per una macchina con CPU ad alta frequenza. Oltre 48 slot serve un abbonamento Cfx.re Element Club. Framework come ESX e QBox sono open source e gratuiti.

Serve una copia di GTA V per ospitare il server?

Per scaricare e avviare FXServer no, ma per collegarti e testare il tuo stesso server sì: ti serve una copia legittima di GTA V per PC, esattamente come per ogni giocatore che entrerà. Le copie piratate falliscono la verifica di Cfx.re.

Meglio ESX o QBCore per un server italiano?

Per chi inizia, ESX è la scelta più semplice grazie all’enorme quantità di documentazione e script disponibili, molti in italiano. QBCore e il suo fork QBox offrono un’architettura più moderna ma richiedono più esperienza. In ogni caso, non mischiare script dei due ecosistemi senza un bridge di compatibilità.

Perché i giocatori restano bloccati su «Connecting»?

Nel 99% dei casi la porta UDP 30120 è chiusa sul firewall o manca la riga endpoint_add_udp in server.cfg. Il server FiveM ha bisogno sia della TCP sia della UDP sulla 30120. Apri entrambe e il problema sparisce.

Posso aprire un server FiveM su Windows?

Sì, FXServer esiste anche per Windows e usi FXServer.exe al posto di run.sh. Per la produzione, però, Linux è preferibile: prestazioni migliori, gestione via systemd e footprint più leggero. Windows va bene per test locali o per chi non ha familiarità con la riga di comando Linux.

Quanti giocatori può reggere un server FiveM?

Senza OneSync il limite è 32. Con OneSync attivo (set onesync on) puoi arrivare fino a 2048 slot in teoria, ma il tetto reale è imposto dalla CPU e dagli script. Un server nuovo dovrebbe partire da 32 o 48 slot e crescere solo quando i numeri lo giustificano.

Aprire un server FiveM è legale?

Sì. Dal 2023 Cfx.re fa parte di Rockstar Games, quindi l’auto-hosting è sanzionato dal publisher. Le uniche condizioni sono possedere copie legittime di GTA V e usare una chiave di licenza gratuita. La vendita di vantaggi di gioco (pay-to-win) è invece vietata dalle policy Cfx.re.

Devo preoccuparmi del GDPR per il mio server?

Se raccogli dati dei giocatori (ID Discord, IP, log) e operi in Europa, sì. Pubblica un’informativa sulla privacy, conserva i log solo il tempo necessario, cifra i backup e offri un modo per richiedere la cancellazione dei dati. Sono buone pratiche semplici che ti tengono in regola.

Approfondimenti correlati

Hai ora tutto il necessario per portare online un server FiveM e trasformarlo in una base solida per il GTA RP. Parti dal server vanilla in 30 minuti, verifica che funzioni, poi aggiungi framework, database e sicurezza con calma. Il resto – gli script, le trame, la community – è la parte divertente, e ora hai le fondamenta tecniche per costruirla senza sorprese.