# Assetto Corsa Server Troubleshooting (/docs/assetto-corsa/troubleshooting)



This guide covers the most common Assetto Corsa server issues and how to fix them. The first section covers issues you'll hit with the **[Assetto Corsa Server Manager](/docs/assetto-corsa/getting-started)**; the later sections are config-level fixes for advanced users editing `server_cfg.ini` by hand.

Server goes offline after starting a race [#server-goes-offline-after-starting-a-race]

**Symptom:** You start a race in the manager, then the server flips to **offline** and doesn't appear in the in-game browser.

**Cause:** The server can't be reached on its game ports, so the lobby drops it. This is reachability, not your race config.

**Fixes:**

* Check the TCP / UDP / HTTP ports in [Server Options](/docs/assetto-corsa/server-options) match the ports on your XGamingServer panel.
* On a newly created server, or after changing ports, **rebuild/reinstall** once from the panel so the new port mappings apply (a plain restart isn't enough).
* Keep **Register to lobby** enabled.
* Full walkthrough: [Getting Into the Lobby](/docs/assetto-corsa/getting-into-lobby).

***

Can't start or save a race / track shows no pit boxes [#cant-start-or-save-a-race--track-shows-no-pit-boxes]

**Cause:** The track content is incomplete — it's missing its `ui/ui_track.json`, which defines pit boxes. Without it the race builder can't lay out the grid and may error.

**Fixes:**

* Re-download a **complete** version of the track and re-upload it on the [Tracks page](/docs/assetto-corsa/uploading-content).
* For multi-layout tracks, make sure each layout folder has its own `ui_track.json`.
* Stock Kunos tracks always include this — if a stock track misbehaves, restart the server so content reloads.

***

Login won't stay signed in [#login-wont-stay-signed-in]

**Symptom:** You log into the manager and get bounced back to the login screen.

**Cause:** You're reaching the manager from a different address than the one in your URL bar, so the session cookie doesn't stick.

**Fix:** Always open the manager with the full `http://YOUR_SERVER_IP:WEB_PORT` address — including the port — and log in from that same address.

***

Cars or tracks not showing in the picker [#cars-or-tracks-not-showing-in-the-picker]

**Fixes:**

* After uploading content, **start or restart** an event — Assetto Corsa loads content at launch, so new cars/tracks appear after a restart.
* If content is installed but the list looks empty or stale, restart the server so the manager re-indexes it.
* Confirm you uploaded the **folder** (e.g. `my_car/`), not a zip or loose files.

***

Plugin not starting [#plugin-not-starting]

**Fixes:**

* Confirm the plugin's files are in the right install directory.
* Make sure its **UDP plugin port** isn't already in use by another plugin — run multiple plugins through a proxy. See [Plugins → UDP plugin ports](/docs/assetto-corsa/plugins).
* Restart the server after enabling a plugin; plugins only load at launch.

***

Required Ports [#required-ports]

| Port | Protocol  | Purpose                             |
| ---- | --------- | ----------------------------------- |
| 9600 | TCP + UDP | Game traffic                        |
| 8081 | TCP + UDP | Lobby registration (server browser) |

Both must be open. On XGamingServer, ports are handled automatically.

***

Server Not Appearing in Browser [#server-not-appearing-in-browser]

**Fixes:**

* Confirm `REGISTER_TO_LOBBY=1` in `server_cfg.ini`
* Ensure HTTP port (8081) is open TCP and UDP
* Wait 1–2 minutes after startup for lobby registration
* Try connecting via direct IP as a workaround

***

"No Available Slots" When Joining [#no-available-slots-when-joining]

**Cause:** `MAX_CLIENTS` is higher than the number of `[CAR_N]` entries in `entry_list.ini`, or the car model name doesn't match.

**Fix:**

* Count your `[CAR_N]` entries — you need at least as many as `MAX_CLIENTS`
* Verify each `MODEL=` value matches an actual folder in `content/cars/`

***

Custom Car Not Loading [#custom-car-not-loading]

**Fixes:**

* Check that the `data/data.acd` file exists inside the car folder on the server
* The folder name in `content/cars/` must exactly match `MODEL=` in `entry_list.ini` and the `CARS=` line in `server_cfg.ini`

***

Custom Track Not Loading / Server Crashes on Track Load [#custom-track-not-loading--server-crashes-on-track-load]

**Fixes:**

* Verify `data/surfaces.ini` exists in the track folder
* If the track has multiple layouts, `CONFIG_TRACK` must match a valid layout subfolder name — or leave it empty for the default layout
* Check capitalization — folder names are case-sensitive on Linux

***

Players Get Wrong Car [#players-get-wrong-car]

**Cause:** In pickup mode, players can choose any listed car. Without pickup mode, slots are assigned sequentially.

**Fix:**

* If you want players to choose their car: `PICKUP_MODE_ENABLED=1`
* If you want assigned slots: `PICKUP_MODE_ENABLED=0` and lock specific GUIDs to `[CAR_N]` entries

***

Can't Use Admin Commands [#cant-use-admin-commands]

**Fixes:**

* Make sure `ADMIN_PASSWORD` is set in `server_cfg.ini`
* In-game, type `/admin YourPassword` in chat first
* Admin access is per-session — you must re-authenticate after every reconnect

***

Server Closes After Race Ends [#server-closes-after-race-ends]

**Cause:** `LOOP_MODE=0` (default behavior).

**Fix:** Set `LOOP_MODE=1` in `[SERVER]` to restart sessions automatically after the race.

***

Players Disconnecting with High Ping [#players-disconnecting-with-high-ping]

**Fix:** Add a ping limit to `[SERVER]` in `server_cfg.ini`:

```ini
MAX_CONTACTS_PER_KM=10
```

Or limit ping in the Assetto Corsa server lobby settings.

***

Mod Content Mismatch [#mod-content-mismatch]

**Cause:** Players don't have the same custom content installed.

**Fix:** All players must have the exact same custom cars and tracks installed locally. Share download links with your community. [Content Manager](https://assettocorsa.club/content-manager.html) can help players manage content.

***

> 💡 **Still stuck?** Join our [Discord](https://discord.xgamingserver.com) for support.

Related Guides [#related-guides]

* [Configure Your Server](/docs/assetto-corsa/configure-your-server)
* [Install Custom Cars & Tracks](/docs/assetto-corsa/install-mods)
* [Admin Commands](/docs/assetto-corsa/admin-commands)
