# BeamMP Server Troubleshooting (/docs/beammp/fix-issues)



import { Step, Steps } from 'fumadocs-ui/components/steps';

Auth Key Errors [#auth-key-errors]

| Console Message                                     | Cause                                                 | Fix                                                                                                     |
| --------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `No AuthKey Specified`                              | The `AuthKey` field is empty                          | Paste your key in **Startup** tab or `ServerConfig.toml`. See [Auth Key guide](/docs/beammp/auth-key).  |
| `Backend system refused server! Check your AuthKey` | Key is invalid, revoked, or running on another server | Check [Keymaster](https://beammp.com/keymaster) — is the key still there? Generate a new one if needed. |
| `[WARN] Backend failed to respond to a heartbeat`   | BeamMP backend temporarily unreachable                | Wait 5–10 minutes. Check [BeamMP Discord](https://discord.gg/beammp) for status.                        |

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

Check in this order:

<Steps>
  <Step>
    Verify Private is false [#verify-private-is-false]

    In **Startup** or `ServerConfig.toml`, ensure `Private = false`.
  </Step>

  <Step>
    Check auth key [#check-auth-key]

    The key must be valid and not in use on another server. See [Auth Key](/docs/beammp/auth-key).
  </Step>

  <Step>
    Check the Console [#check-the-console]

    In the **Console** tab of the [XGamingServer Panel](https://panel.xgamingserver.com), look for error messages. A successful start shows the server registering with the backend.
  </Step>

  <Step>
    Wait 1–2 minutes [#wait-12-minutes]

    New/restarted servers take a moment to register with BeamMP's master server.
  </Step>
</Steps>

"Socket Error" / Stuck on Connecting [#socket-error--stuck-on-connecting]

Usually caused by **corrupted or incompatible mod files**, especially after a BeamNG.drive update.

Server-Side Fix [#server-side-fix]

<Steps>
  <Step>
    Isolate the problem [#isolate-the-problem]

    In **Files**, rename `Resources/Client/` to `Resources/Client_backup/`. Create an empty `Resources/Client/` folder.
  </Step>

  <Step>
    Test the connection [#test-the-connection]

    Restart the server and try connecting. If it works, a mod file is corrupted.
  </Step>

  <Step>
    Find the bad mod [#find-the-bad-mod]

    Move mods back from `Client_backup/` one at a time, testing after each. The one that breaks it is corrupted — delete and re-download it.
  </Step>
</Steps>

Client-Side Fix [#client-side-fix]

If the problem is on a specific player's end:

1. Deactivate all mods in BeamNG's Mod Manager
2. Re-enable only **MultiplayerBeamMP**
3. Try connecting again

Can't Join Own Server via Browser [#cant-join-own-server-via-browser]

Most home routers don't support **NAT loopback** (connecting to your own public IP from inside the network).

**Fix:** Use **Direct Connect** with `127.0.0.1:30814` instead of the server browser.

Port Forwarding Not Working [#port-forwarding-not-working]

* Verify **both TCP and UDP** are forwarded on port 30814
* Check for **CGNAT** — if your router's WAN IP differs from your public IP (check at [whatsmyip.org](https://whatsmyip.org)), port forwarding won't work. This is why hosted servers like XGamingServer avoid this issue entirely.
* VPNs (Hamachi, RadminVPN) are **not officially supported** and cause UDP issues

Cars Not Moving [#cars-not-moving]

Check that the player's **system date and time** are correct. Incorrect time causes sync failures.

Server Overloaded / Rubber-banding [#server-overloaded--rubber-banding]

* Lower `MaxCars` — see [Vehicle Limits](/docs/beammp/vehicle-limits)
* Lower `MaxPlayers`
* Remove large/complex vehicle mods from `Resources/Client/`
* Check **Dashboard** in the panel for CPU and RAM usage

Related Guides [#related-guides]

* [Auth Key](/docs/beammp/auth-key)
* [Server Configuration](/docs/beammp/server-config)
* [Install Mods](/docs/beammp/mod-setup)
* [Vehicle Limits](/docs/beammp/vehicle-limits)