Skip to main content

List your server on FiveM

This guide explains how to make your FiveM server visible in the public server list.

Prerequisites​

Obtain a license key​

You must obtain your own license key from the Cfx.re portal.

Important

Each server requires its own unique license key. Never use the same key for multiple servers.

Configuring server.cfg​

1. Privacy configuration​

Add this line to protect certain server information:

sv_endpointPrivacy true

2. Public listing configuration​

Enable direct listing and configure the public IP address:

# Enable FiveM listing view
set sv_useDirectListing true

# Public IP of your server (WITHOUT the port)
set sv_listingIPOverride "51.91.123.45"
Using a subdomain

You can use a subdomain IP like game-node6.yorkhost.fr (without specifying the port in this variable).

3. Server information​

Configure the name and description that will appear in the list:

# Your server name
sets sv_projectName "[US] My Roleplay Server"

# Your project description
sets sv_projectDesc "English RP server with realistic economy"

4. Technical configuration​

# Enable OneSync
# 'on' = infinity (more than 64 slots)
# 'legacy' = up to 64 slots
set onesync on

# Steam API key (optional, use 'none' if not needed)
set steam_webApiKey none

# Your FiveM license key
set sv_licenseKey YOUR_CFX_RE_KEY

# Maximum number of players
sv_maxclients 64

Complete example configuration​

Here's a complete configuration example:

# Privacy
sv_endpointPrivacy true

# Public listing
set sv_useDirectListing true
set sv_listingIPOverride "51.91.123.45"

# Server information
sets sv_projectName "[US] YorkCity RP"
sets sv_projectDesc "English RP server - Realistic economy"
sets tags "rp, english, whitelist"

# Technical configuration
set onesync on
set steam_webApiKey none
set sv_licenseKey cfxk_YOUR_KEY_HERE
sv_maxclients 64

# Hostname visible in console
sv_hostname "YorkCity RP - discord.gg/example"

Validation and verification​

1. Remove sv_master1​

If you have the following line in your server.cfg, delete it:

sv_master1 ""  # TO BE DELETED
warning

The presence of sv_master1 may prevent proper server listing.

2. Restart the server​

  1. Save your server.cfg file
  2. Completely restart your FiveM server
  3. Wait 2-3 minutes for propagation

3. Check the listing​

Go to the FiveM server list and search for your server by name.

Common issues​

Server doesn't appear in the list​

Checks:

  • The license key is valid and correctly entered
  • sv_useDirectListing is set to true
  • sv_listingIPOverride contains the correct public IP
  • sv_master1 has been removed from the file
  • The server is started and accessible

Solution: Wait 5-10 minutes after restart, listing may take time.

Server appears as "Private"​

Check that you don't have:

sv_lan true  # Private server mode

This option makes the server invisible in the public list.

Incorrect information displayed​

If the name or description doesn't display correctly:

  • Use sets (not set) for sv_projectName and sv_projectDesc
  • Avoid unsupported special characters
  • Restart the server after modification

JSON errors (JsonReaderException)​

If you encounter errors like:

Newtonsoft.Json.JsonReaderException: Error reading JArray from JsonReader. Path '', line 0, position 0.

Cause: These errors and similar JSON-related errors are typically caused by your server not being properly listed on the FiveM public server list.

Solution:

  1. Verify that your server is correctly configured following the steps above
  2. Ensure sv_useDirectListing is set to true
  3. Check that sv_listingIPOverride contains your correct public IP
  4. Confirm your license key is valid
  5. Remove any sv_master1 directive from your server.cfg
  6. Restart your server and wait 5-10 minutes for the listing to propagate

Going further​

Custom tags​

Add tags to improve server discovery:

sets tags "rp, english, whitelist, economy, jobs"

Locale​

Set your server language:

sets locale "en-US"

You can add a custom banner:

sets banner_detail "https://example.com/banner.png"
sets banner_connecting "https://example.com/loading.png"
info

Make sure images are hosted on a publicly accessible server and URLs use HTTPS.