Skip to content

Why your console shows "Server list query returned an error"

Right after starting (or restarting) a FiveM server, you may see a line like this in the console:

[citizen-server-impl] Server list query returned an error: server request failed:
server request failed for endpoint https://<ip>:<port>/dynamic.json
(Get "https://<ip>:<port>/dynamic.json": EOF)

This is harmless. Your server is up, players can connect on the address shown on your dashboard, and the warning disappears on its own within a few minutes.

What's actually happening

FiveM keeps a public master server list. Once your server boots, it sends a heartbeat to that master, and the master periodically pings back your dynamic.json endpoint to confirm the server is still online and to refresh its data (player count, hostname, etc.).

The master indexes those endpoints by your license key. If the same license key was previously used on a different machine (for example, you migrated from another host, recreated the server, or moved between providers), the master may still be probing an outdated endpoint while it catches up with your new one. Those probes fail, the master reports the failure back to your server, and FiveM logs the warning into your console.

What Zaroz Cloud already does for you

Every time your container starts, we patch your server.cfg to match the IP and port we've actually allocated to you. Specifically, our entrypoint:

  1. Removes any existing endpoint_add_tcp, endpoint_add_udp, and set sv_listingIpOverride lines.
  2. Prepends fresh ones bound to your real port and your public IP.

That means the server itself is correctly advertising the right endpoint to the master. The transient error you see is purely on the master's side, not in your configuration.

When it resolves

The FiveM master server refreshes its endpoint cache after a few successful heartbeats from your server. In practice:

  • Most cases: the warning disappears in 2 to 5 minutes.
  • Worst case: up to about 15 minutes after the first start with a new license assignment.

You don't need to restart, change anything in server.cfg, or open a ticket during that window. Players using the address from your dashboard are unaffected.

When to contact support

Get in touch if:

  • The error keeps appearing for more than 30 minutes after a fresh start.
  • Players cannot connect using the address from your dashboard.

In those cases, send us the full log line and your order ID so we can check the routing on our side.