FiveM · Config reference

FiveM server.cfg reference

Where FiveM's server.cfg lives, what each important setting does, which lines moved to the Cfx.re Portal, and how admins, ACE permissions and bans work.

By Last reviewed 5 min read

FiveM servers are coming soon

Cfx.re only lets hosts it has authorized sell FiveM servers, and servers on other hosts get blocked. FiveM opens on Wilderack the day Cfx.re approves us as a hosting partner. These guides are ready for the day we open.

Join the FiveM waitlist

A FiveM server is set up by one text file, server.cfg, in the server’s main folder. It sets the ports, player slots, game build and admins, and lists which resources (scripts) to start. Your server list name and description no longer live there: they’re on the Cfx.re Portal.

Where the files are

File or folder What it holds
server.cfg The main settings, admin lines and ensure lines
Other .cfg files Extra settings that server.cfg loads with exec. Qbox, for example, splits its settings into permissions.cfg, ox.cfg, voice.cfg and misc.cfg
resources/ Every resource, often grouped in folders with brackets, like [qb] or [standalone]
txData/ txAdmin’s own data: its admins (admins.json), settings, and the player list with bans, warnings and the whitelist

How to change settings

You have three ways in:

  • Settings in the panel: the main options in plain words, plus the license key field.
  • Settings > Advanced: the real server.cfg, in a text editor.
  • Files, or SFTP (works with FileZilla): every file, including the extra .cfg files and resources.

FiveM reads server.cfg when it starts, so restart the server after you change it. If you edit a file while the server sleeps, the change applies the next time it starts.

The settings that matter

Line in server.cfg Example What it does
endpoint_add_tcp "0.0.0.0:30412" The port players connect to, for TCP. Must match the port on your address card
endpoint_add_udp "0.0.0.0:30412" The same port, for UDP. Must match too
sv_licenseKey "your-key" Your license key. On Wilderack it lives in the panel’s license key field instead. See your license key
sv_maxclients 48 Most players at once, 1 to 2048. Over 48 needs Element Club. 32 and up needs OneSync, and over 64 needs set onesync on
set onesync on FiveM’s server-side sync. on is the normal choice and every recipe uses it. legacy is only for very old scripts
sv_enforceGameBuild 3570 Which GTA V update players load, so newer cars, maps and clothes work. Startup only
ensure ensure chat Starts a resource, or restarts it if it’s running. One line per resource or bracket folder
exec exec permissions.cfg Loads another .cfg file
sv_scriptHookAllowed 0 0 blocks players who use Script Hook V menus. Keep it at 0
sv_endpointPrivacy true Hides players’ IP addresses in the server’s public reports
sv_enforceSteamAuth true Players must link Steam to their Cfx.re account to join. Needed if scripts or bans use steam: IDs
sv_entityLockdown strict Stops players’ game clients from creating cars, people and objects on their own, which helps against cheaters. Default inactive. Test it first, because some scripts need it off
sets sv_appearAllowlisted true Shows a padlock on your listing, for allowlisted servers
sv_master1 "" Makes the server private: it stays in the list, but its Connect button is greyed out. Leave the line out, or keep the # in front of it, to stay joinable
sv_tebexSecret "your-secret" Connects your Tebex store. See server owner rules

The ports in endpoint_add_tcp and endpoint_add_udp must be the port picked for your server. The panel writes them for you. If you paste in someone else’s server.cfg, put your own port back.

Game builds

sv_enforceGameBuild takes a build number or its name. Some recent ones:

Build Name GTA V update
3407 mp2024_02 Agents of Sabotage
3570 mp2025_01 Money Fronts
3751 mp2025_02 A Safehouse in the Hills
3889 mp2026_01 The Kortz Center Heist

Each build includes everything from the builds before it. Players’ games switch to the server’s build when they join, which can mean a game restart. On FiveM for GTA V Enhanced, the newest build loads by default.

Lines that moved to the Cfx.re Portal

Cfx.re moved your server list entry to the Portal. These lines no longer control it, and Cfx.re’s own default config says they can’t be set in server.cfg anymore:

Old line Set it on the Portal as
sv_hostname, sets sv_projectName Name
sets sv_projectDesc Description
sets locale Language
sets tags Tags (up to five)
sets banner_detail, sets banner_connecting Banner
load_server_icon Icon

The Portal also asks for a Tagline, which is new. Leaving the old lines in does no harm. Change the real values under Edit Server Details on the Portal, as shown in your server list entry.

Steam Web API keys stopped working

steam_webApiKey and steam_webApiDomain stopped working on November 4, 2026. If your scripts, bans or admin lines use steam: identifiers, add set sv_enforceSteamAuth true instead. It needs server version 38004 or newer.

Admins and permissions

FiveM’s own permission system is called ACE. Two kinds of lines in server.cfg set it up:

# Let the admin group use every command, except quit
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Put a player in the admin group
add_principal identifier.fivem:1234567 group.admin
  • add_ace gives a group (or a player) permission to do something.
  • add_principal puts a player in a group. Players are named by an identifier, such as identifier.fivem: (their Cfx.re account), identifier.license: (their Rockstar license) or identifier.discord:.

txAdmin’s player page lists each player’s identifiers once they’ve joined. Frameworks add their own groups on top. QBCore, ESX and Qbox each document theirs, so follow your framework’s guide for its admin commands.

Allowlist and bans

FiveM itself has no ban or whitelist file. Most servers use txAdmin:

  • Bans and warnings are made from the txAdmin web page or the /tx menu in game. txAdmin stores them in txData.
  • The whitelist has four modes: admin-only, approved license, Discord member and Discord role. Turn it on in txAdmin’s settings.
  • txAdmin admins and their permissions are in txData/admins.json. Edit them in txAdmin’s admin manager rather than by hand.

On Wilderack, txAdmin’s web page is closed to the internet by default. You can open it from the panel, which gives it its own port and shows a warning first.

Which changes need a restart

Change Needs
Any line in server.cfg A server restart
sv_enforceGameBuild, onesync A server restart. They only work at startup
One resource’s files ensure name in the Console, or a server restart
A new resource folder refresh in the Console, then ensure name. Add the ensure line to server.cfg too, so it starts next time
Listing details on the Portal Nothing. They update on their own

Questions

Where is server.cfg on a FiveM server?

In the server's main data folder, next to the resources folder. Open Files in the panel and it's at the top level, or edit it under Settings and then Advanced.

Why doesn't sv_hostname change my FiveM server name?

Cfx.re moved the server list name, description, tags and language to the Cfx.re Portal, and the old server.cfg lines no longer change them. Edit them on the Portal under Servers, then your server, then Edit Server Details.

How do I make myself admin on a FiveM server?

Add add_principal identifier.fivem:YOURID group.admin to server.cfg, with your FiveM ID in place of YOURID, and make sure group.admin has add_ace group.admin command allow. Restart the server. txAdmin admins can also use the /tx menu in game.

Do I need to restart after changing server.cfg?

Yes, for most lines. FiveM reads server.cfg when it starts. Some lines, like sv_enforceGameBuild, only work at startup. A single resource can be restarted in the console with ensure and its name.

Sources we checked

  1. Server commandsCfx.re
  2. Setting up a vanilla FXServer (example server.cfg)Cfx.re
  3. Default FiveM recipe server.cfgCfx.re
  4. txAdmin permissionsCfx.re

Be first to host FiveM

Cfx.re only lets hosts it has authorized sell FiveM servers, and servers on other hosts get blocked. FiveM opens on Wilderack the day Cfx.re approves us as a hosting partner. Join the waitlist and we’ll email you the day it opens.