# The Isle Evrima Server Troubleshooting (/docs/the-isle-evrima/troubleshooting) import { Step, Steps } from 'fumadocs-ui/components/steps'; Common issues and how to fix them on your The Isle Evrima server. Server Not Showing in the Browser [#server-not-showing-in-the-browser] **Wait first** — after a restart it takes 2–5 minutes for a server to register with EOS and appear in the browser. If it still doesn't show: | Check | Fix | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Server is running | Check **Console** for errors. Server must show "Server listening" | | EOS credentials | Verify `Engine.ini` has the `[EpicOnlineServices]` section with the right `DedicatedServerClientId` and `DedicatedServerClientSecret`. Without these, the server won't register | | Unique server name | Make sure `ServerName` is set in **Startup** or `Game.ini` | | Max ping filter | In the player's game **Settings** > **In-Game**, set max ping filter to 500–1000 | | Players on Evrima branch | All players must be on the `evrima - public` Steam beta branch, not Legacy | Players Can't Connect [#players-cant-connect] Verify the server is online [#verify-the-server-is-online] Open the **Console** in the panel. The status should be green/running. Look for any errors in recent log lines. Check version and branch [#check-version-and-branch] All players must be on the **evrima** beta branch in Steam (right-click The Isle > Properties > Betas). Both server and client must be the same Evrima version. Verify ports [#verify-ports] Confirm UDP **7777–7779** are accessible. Check the IP and port shown on **Network** in the panel. Check password [#check-password] If `bServerPassword=true`, players need the exact case-sensitive password. Check whitelist [#check-whitelist] If `bServerWhitelist=true`, the player's SteamID64 must be in `WhitelistIDs=` in `Game.ini`. Check server isn't full [#check-server-isnt-full] If `MaxPlayerCount` is reached and `bQueueEnabled=false`, players are rejected. Enable the queue with `bQueueEnabled=true`. "Data Acquisition Failed" [#data-acquisition-failed] The most common client-side error in Evrima. Your server appears in the browser, but the client can't fetch its EOS session data when joining. | Cause | Fix | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Server just restarted** | Wait 1–2 minutes after the map finishes loading — EOS session registration takes 30–60 seconds | | **QueryPort conflict** | `QueryPort` in `Game.ini` must be **different** from the game port. Check **Startup** in the panel for the assigned value | | **QueryPort mismatch** | The `QueryPort=` value in `Game.ini` must match the `-QueryPort=` startup argument — don't hand-edit one without the other | | **Port not allocated** | XGamingServer allocates the query port automatically. If you reset configs, verify `QueryPort` matches the value shown in **Startup** | | **EOS outage** | If every Evrima server is affected, check [EOS status](https://status.epicgames.com/) or [The Isle Discord](https://discord.gg/theisle). Nothing can be fixed server-side | > `QueuePort` can share the same value as `QueryPort` per the official docs. If the queue isn't needed, set `bQueueEnabled=false` in `Game.ini`. Client Connection Timeout [#client-connection-timeout] If players see the following in their client log: ``` UNetConnection::Tick: Connection TIMED OUT. Closing connection.. Elapsed: 20.01, Threshold: 20.00 ``` | Cause | Fix | | ------------------------- | ---------------------------------------------------------------------------------------- | | Server crashed | Check **Console** — the server may have gone offline. Restart from the panel | | EOS net driver failed | Restart the server to reinitialize the EOS connection | | Client-side network issue | Player should verify their connection and ping to the server | | Server overloaded | Check CPU and memory in **Activity**. Lower `AIDensity` or `MaxPlayerCount` if saturated | Server Crashes on Startup [#server-crashes-on-startup] Check the **Console** logs — the error usually appears right before the crash. | Cause | Fix | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Bad Game.ini syntax** | Typo or invalid value. Check for missing quotes, wrong section headers (`[/Script/TheIsle.TIGameSession]`), or invalid types | | **Missing EOS credentials** | Add the `[EpicOnlineServices]` block to `Engine.ini`. See [Server Configuration](/docs/the-isle-evrima/server-config) | | **Corrupted install** | Stop server, delete all files, click **Reinstall Server** on the Dashboard. See [Wipe & Reinstall](/docs/the-isle-evrima/wipe-reinstall) | | **Out of memory** | Lower `MaxPlayerCount` or `AIDensity`. See [Server Requirements](/docs/the-isle-evrima/server-requirements) | | **Port conflict** | If RCON port (8888) or Queue port (10000) is in use, change them in `Game.ini` | Server Starts Then Immediately Stops [#server-starts-then-immediately-stops] This usually means the server initialized but failed during startup. Check the **Console** for the last few lines. | Cause | Fix | | ------------------- | ------------------------------------------- | | Invalid `MapName` | Currently the only valid value is `Gateway` | | RCON port conflict | Change `RconPort` to a different value | | Queue port conflict | Change `QueuePort` to a different value | | EOS auth failed | Engine.ini credentials are wrong or missing | High Ping or Lag [#high-ping-or-lag] | Check | Fix | | ----------------------------- | ----------------------------------------------------------------------------------- | | **Server resource usage** | Check **Activity** in the panel. If CPU or RAM is at 100%, the server is overloaded | | **AI density too high** | Lower `AIDensity` to `0.5` in `Game.ini`. Biggest single performance gain | | **Too many AI checks** | Increase `AISpawnInterval` to `60` or `90` | | **Too many corpses** | Run `wipecorpses` via RCON periodically | | **Player count exceeds plan** | Either reduce `MaxPlayerCount` or upgrade your plan | Server Password Not Working [#server-password-not-working] **Symptom:** The server appears in the browser, the password prompt opens, but entering the password does nothing — no connection attempt, no error, no entries in the server log. **Cause:** As of Evrima `v0.21.1417`, the server password feature does not work in containerized hosting environments. Both `ServerPassword=password` and the quoted `ServerPassword="password"` (per official docs) silently fail. This is not a formatting issue — the connection attempt never reaches the server. **Fix:** Disable the password and use a [whitelist](/docs/the-isle-evrima/whitelist) for access control. In `Game.ini`: ```ini [/Script/TheIsle.TIGameSession] bServerPassword=false bServerWhitelist=true [/Script/TheIsle.TIGameStateBase] WhitelistIDs=76561198000000001 WhitelistIDs=76561198000000002 ``` Connection works immediately after disabling the password. Whitelisting by SteamID64 is also stronger access control — passwords get shared and leaked, Steam IDs don't. > 📝 **Note:** The `Steam Dedicated Server API failed to initialize` warning that appears in the console is normal in containerized hosting and is unrelated to this issue. No Dinosaurs in Selection Screen [#no-dinosaurs-in-selection-screen] **Symptom:** Players connect successfully but the dinosaur selection list is empty or never finishes loading. **Cause:** The `AllowedClasses` entries are missing from `[/Script/TheIsle.TIGameStateBase]` in `Game.ini`. Evrima requires these to be explicitly listed — without them, the picker shows nothing. This usually happens after a manual edit to `Game.ini` removed the block, or after restoring an incomplete config from backup. **Fix:** Stop the server, open `TheIsle/Saved/Config/LinuxServer/Game.ini`, and add all 20 `AllowedClasses` entries under `[/Script/TheIsle.TIGameStateBase]`: ```ini [/Script/TheIsle.TIGameStateBase] AllowedClasses=Tyrannosaurus AllowedClasses=Allosaurus AllowedClasses=Carnotaurus AllowedClasses=Ceratosaurus AllowedClasses=Deinosuchus AllowedClasses=Dilophosaurus AllowedClasses=Herrerasaurus AllowedClasses=Omniraptor AllowedClasses=Pteranodon AllowedClasses=Troodon AllowedClasses=Diabloceratops AllowedClasses=Dryosaurus AllowedClasses=Hypsilophodon AllowedClasses=Maiasaura AllowedClasses=Pachycephalosaurus AllowedClasses=Tenontosaurus AllowedClasses=Stegosaurus AllowedClasses=Triceratops AllowedClasses=Beipiaosaurus AllowedClasses=Gallimimus ``` Save the file and restart. The full picker should reappear. To restrict the roster to fewer species, see [Playable Dinosaurs](/docs/the-isle-evrima/playable-dinosaurs). RCON Not Working [#rcon-not-working] | Check | Fix | | --------------------- | ------------------------------------------------------------------------------ | | `bRconEnabled=true` | Must be set in `Game.ini` | | Correct port | Default is `8888` (TCP) — verify it's open | | Correct password | The password is case-sensitive | | Using a custom client | **Standard Source RCON tools won't work** — use a community Evrima RCON client | | Restart after editing | Always restart the server after changing RCON settings | See [RCON Setup](/docs/the-isle-evrima/rcon-setup) for the full guide. Whitelist Not Working [#whitelist-not-working] | Check | Fix | | ------------------------ | --------------------------------------------------------------------------- | | `bServerWhitelist=true` | Must be set under `[/Script/TheIsle.TIGameSession]` | | Steam IDs are correct | Use [steamid.io](https://steamid.io) to verify SteamID64 format (17 digits) | | Restart after editing | Or use `togglewhitelist` via RCON to reload | | IDs in the right section | `WhitelistIDs=` should be under `[/Script/TheIsle.TIGameSession]` | Still Stuck? [#still-stuck] Join our [Discord](https://discord.xgamingserver.com) and open a support ticket. Include: * Your server ID * The relevant errors from your **Console** tab * A description of what you tried Related Guides [#related-guides] * [Server Configuration](/docs/the-isle-evrima/server-config) * [Getting Started](/docs/the-isle-evrima/getting-started) * [Server Requirements](/docs/the-isle-evrima/server-requirements) * [Connect to Your Server](/docs/the-isle-evrima/join-server)