# How to Troubleshoot Common Arma Reforger Server Issues (/docs/arma-reforger/troubleshooting)



Here are the most common Arma Reforger server issues and how to fix them.

Connection Issues [#connection-issues]

Players can't find the server in the browser [#players-cant-find-the-server-in-the-browser]

**Causes and fixes:**

1. **Server not set to visible** — In `Arma Reforger Config` on the [XGamingServer panel](https://panel.xgamingserver.com), go to the **Network** tab and set visibility to `true`
2. **Wrong port** — Verify the port in `Network` matches your config
3. **Server still starting** — Wait for the server to fully initialize in `Console`
4. **Outdated server version** — Update to the latest version

"Version mismatch" error [#version-mismatch-error]

**Cause:** Server and client are on different Arma Reforger versions.

**Fix:** Update your server to match the current game version. Check `Console` for the server version on startup.

Players disconnecting frequently [#players-disconnecting-frequently]

**Causes:**

* Server performance issues — See [Performance Guide](/docs/arma-reforger/performance-guide)
* Too many players for server resources
* Mod conflicts causing instability
* Network configuration issues

Server Crashes [#server-crashes]

Server crashes on startup [#server-crashes-on-startup]

**Fixes:**

1. Check `Console` for error messages — they usually indicate the cause
2. Remove recently added mods and test
3. Verify config file syntax — invalid JSON will prevent startup
4. Reset to default config by deleting the config and restarting

Server crashes during gameplay [#server-crashes-during-gameplay]

**Common causes:**

* **Memory exhaustion** — Check RAM usage on `Dashboard`. Increase allocation if maxed
* **Mod conflicts** — Disable mods one by one to find the culprit
* **Scenario bugs** — Try a different scenario to isolate the issue
* **Corrupt save data** — Try loading a [backup](/docs/arma-reforger/automatic-backups)

Mod Issues [#mod-issues]

Mods not loading [#mods-not-loading]

1. Check the **Mods** tab in `Arma Reforger Config` — verify mod IDs are correct
2. Ensure mod versions are compatible with your server version
3. Check `Console` for mod loading errors
4. Verify players have the same mods installed on their client

Mod causing server lag [#mod-causing-server-lag]

1. Monitor server performance with and without the suspect mod
2. Check the mod's workshop page for known performance issues
3. Try reducing the number of concurrent mods
4. Report persistent issues to the mod author

Configuration Issues [#configuration-issues]

Settings not applying after restart [#settings-not-applying-after-restart]

1. Save changes in `Arma Reforger Config` before restarting
2. Check for JSON syntax errors — a misplaced comma or bracket can invalidate the entire config
3. Verify you're editing the correct config file via `Files`

Config file corrupted [#config-file-corrupted]

If the config becomes unreadable:

1. [Restore from backup](/docs/arma-reforger/automatic-backups) if available
2. Or delete the config file and restart — the server will generate a fresh default config
3. Reconfigure your settings in `Arma Reforger Config`

Performance Issues [#performance-issues]

Low server FPS/tick rate [#low-server-fpstick-rate]

See the [Performance Guide](/docs/arma-reforger/performance-guide) for detailed optimization steps. Quick fixes:

* Reduce player count
* Remove resource-heavy mods
* Switch to a lighter scenario
* Schedule regular [restarts](/docs/arma-reforger/automatic-backups)

> 💡 **Tip:** Always check `Console` first when troubleshooting. Error messages in the log almost always point to the root cause.

> 📝 **Note:** Arma Reforger is in active development. Some issues are engine-level bugs that get fixed in updates. Keep your server updated to the latest version.

See also: [Performance Guide](/docs/arma-reforger/performance-guide) | [Server Logs](/docs/arma-reforger/server-logs) | [Automatic Backups](/docs/arma-reforger/automatic-backups)

If you need help, join our [Discord](https://discord.xgamingserver.com/).