FiveM & GTA RPFiveM server.cfg explained line by line (2026)
Complete guide to the FiveM server.cfg file: server name, slots, tags, banner, resources, admin permissions. Detailed explanation for LordHosting Pterodactyl.
Try this guide on a real FiveM server, free for 12 hours
A FiveM server ready in minutes to put this tutorial into practice, then you decide.
- No credit card
- 12 hours from first launch
- One trial per person
The server.cfg file is the configuration center of your FiveM server. It defines the public identity (name, description, banner), resources loaded at startup, available slots, admin permissions and much more. This guide details each line of the pre-configured file provided with your LordHosting FiveM hosting plan on Pterodactyl.
This guide applies to any FiveM server, including our FiveM hosting plans, where txAdmin and the MySQL database come preinstalled.
⚙️ Where to find the server.cfg file?
On your LordHosting Pterodactyl panel:
- Select your FiveM server
- Click on the "File Manager" tab (left menu)
- At the root, open the
server.cfgfile
A sample server.cfg is pre-configured with basic parameters and slots set according to your plan. You can edit it directly from the panel - each save requires a server restart to take effect.
⚠️ Do not touch: the
endpoint_add_tcpandendpoint_add_udplines related to the port. Pterodactyl rewrites them automatically at startup with the correct port assigned to your server. Any manual modification will be overwritten.
⚙️ Server identity
These lines define how your server appears in the public FiveM list.
sv_hostname
sv_hostname "^4[EN] ^7My Awesome RP Server ^2| ^1Discord.gg/example"
Name displayed in the FiveM server list. You can use FiveM color codes:
| Code | Color |
|---|---|
^0 | Black |
^1 | Red |
^2 | Green |
^3 | Yellow |
^4 | Blue |
^5 | Cyan |
^6 | Magenta |
^7 | White |
^8 | Dark red |
^9 | Gray |
Tip: start the name with [FR], [EN] or [ES] to signal the server's main language.
sv_projectName
sv_projectName "My Awesome RP Server"
Short name of your project, displayed in some FiveM interfaces. No color codes.
sv_projectDesc
sv_projectDesc "English GTA RP server, realistic economy, custom jobs, 100 slots."
Description displayed on the detailed server card. Limited to about 1 line.
sv_maxClients
sv_maxClients 64
Maximum number of slots (concurrent players). Must match the slot count provided by your LordHosting plan: exceeding it will block server startup.
Typical values:
- Small RP startup: 32
- Medium RP community: 64
- Large RP community: 128 to 200
⚙️ Banner and presentation
Loading banner (loadscreen banner)
load_server_icon icon.png
Image displayed next to the server name in the FiveM list. Required format: PNG 96x96 pixels exactly. Upload the icon.png file to your server root via the Pterodactyl File Manager.
Tags
sets tags "roleplay, rp, english, esx, qbcore, hardrp, serious"
Tags used by FiveM search. Help classify your server in the right categories. Separate them with commas. Prioritize:
- The RP type:
hardrp,softrp,lightrp - The language:
english,french,spanish - The framework:
esx,qbcore,qbox - The theme:
mafia,medieval,cartel,realistic,futuristic
Game build (GTA V DLC)
sets sv_enforceGameBuild 3258
Forces a specific version of GTA V (DLC). Important to use certain recent vehicles or MLOs.
Common builds in 2026:
2802: Cayo Perico2944: Contracts3095: Drug Wars3258: The Chop Shop3407: Bottom Dollar Bounties (latest)
⚠️ The more recent the build, the more older scripts may break. Test before pushing to production.
⚙️ Resources and startup
# Base FiveM resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
# Your custom resources
ensure your_framework
ensure your_inventory
ensure your_jobs
ensure loads the resource at startup and automatically restarts it if it crashes.
💡 Loading order: always start with core resources (sessionmanager, mapmanager, etc.), then your framework (ESX, QBCore, QBox), then the resources that depend on it.
To temporarily disable a resource without deleting it, comment the line with #:
# ensure my_broken_script
⚙️ Permissions and administration
ACE system (Access Control Entries)
FiveM uses a permission system called ACE. You define principals (users or groups) and grant them permissions.
# Create an admin group
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Add a user to the admin group (via Steam identifier, license, etc.)
add_principal identifier.license:abc123def456... group.admin
A player's identifier
To add an admin, you need their identifier. Three ways to get it:
- Via server console: type
playerswhen the player is connected - Via a script: most frameworks display player identifiers in the admin interface
- Via logs: on connection, FiveM logs the identifier in the console
Typical format: license:abc123def456... or steam:110000100000000
⚙️ Security and anti-cheat
OneSync mode
set onesync on
set onesync_population true
OneSync is FiveM's network replication system that enables:
- More than 32 concurrent players
- Better entity synchronization
- GTA V population synchronized between players
Recommended for any modern RP server. Included free at LordHosting.
Scripthook disabled
sv_scriptHookAllowed 0
Disables client-side Script Hook usage (basic anti-cheat). Keep on 0 for a serious RP server. Client-side cheats are thus limited.
Connection password (optional)
# sv_password "myPassword"
Uncomment and set a password to make your server private (whitelist beta, closed tests, etc.). Remove for a public server.
⚙️ License and technical identity
Keymaster key
sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXXX_YYYYYY"
Key obtained at keymaster.fivem.net. Without it, your server won't appear in the public list. Check our Keymaster guide to get one.
💡 Recommended alternative: enter your key via the LordHosting Pterodactyl panel "Startup" tab (variable
LICENSE_KEY) rather than inserver.cfg. Cleaner and more secure when sharing configuration.
⚙️ Connection limits
# Limit to 1 connection per IP address
set sv_authMaxVariance 1
set sv_authMinTrust 5
These parameters protect against basic multi-accounting. For stronger protection, use a dedicated anti-cheat system (FiveGuard, Polar Anticheat, etc.).
⚙️ Complete server.cfg example
# === IDENTITY ===
sv_hostname "^4[EN] ^7My RP Server ^2| ^1discord.gg/example"
sv_projectName "My RP Server"
sv_projectDesc "English GTA RP server, realistic economy, ESX, 64 slots."
sv_maxClients 64
# === BANNER & TAGS ===
load_server_icon icon.png
sets tags "roleplay, rp, english, esx, hardrp"
sets sv_enforceGameBuild 3258
# === RESOURCES ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure es_extended
ensure ox_inventory
# Add your custom resources here
# === SECURITY ===
set onesync on
set onesync_population true
sv_scriptHookAllowed 0
# === ADMIN (example) ===
add_ace group.admin command allow
add_principal identifier.license:abc123... group.admin
# === LICENSE (prefer setting it via Startup var) ===
# sv_licenseKey "cfxk_..."
⚙️ Save and restart
After each modification:
- Save the file in the Pterodactyl File Manager
- Go to the "Console" tab
- Click "Restart"
You'll see in console the resources loading one by one. Watch for any errors that appear in red.
⚙️ Common errors
| Error | Cause | Solution |
|---|---|---|
Couldn't find resource X | Resource referenced with ensure but missing from resources/ folder | Check that the resource folder exists and is named correctly |
License key authentication failed | Invalid Keymaster key or linked to another IP | See the Keymaster guide |
sv_maxClients value exceeds limit | Requested slots higher than the plan limit | Reduce sv_maxClients or upgrade the plan |
| Server doesn't appear in list | Missing Keymaster key or invalid game build identifier | Check sv_licenseKey and sv_enforceGameBuild |
⚙️ Going further
- Get your CFX.re Keymaster key: essential step before configuring
server.cfg - ESX vs QBCore: which framework to choose?: to choose your framework
ensurewisely - How to update your FiveM server: up-to-date artifacts to enjoy the latest features
These tools also run on a LordHosting Windows Server VPS: licence included, RDP access, ideal for self-hosting the Windows utilities of your server (build tools, FTP, bots).
Put this guide into practice on your own server
From €10/month. Online in a few minutes, anti-DDoS protection, 7/7 support, no commitment.
Related guides
Update the FiveM Artifacts on Your Server
Complete guide to update your FiveM server hosted on a LordHosting VPS to the latest official version: artifacts, txAdmin, backup and restart.
Connect MySQL to a FiveM Server with oxmysql
Link your MySQL database to FiveM with oxmysql: connection string, start order in server.cfg, importing the ESX or QBCore schema and common errors.
Enable txAdmin on a FiveM Server
Enable txAdmin on your FiveM server: first start, creating the admin account, linking a recipe, scheduled restarts and backups.
ESX vs QBCore: which FiveM framework to choose in 2026?
Complete 2026 comparison of ESX legacy vs QBCore: architecture, performance, available scripts, community, modularity.

