How to Troubleshoot Common Arma Reforger Server Issues

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

Connection Issues

Players can't find the server in the browser

Causes and fixes:

1. Server not set to visible — In Arma Reforger Config on the XGamingServer panel, 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

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

Causes:

• Server performance issues — See Performance Guide
• Too many players for server resources
• Mod conflicts causing instability
• Network configuration issues

Server Crashes

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

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

Mod Issues

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

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

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

If the config becomes unreadable:

1. Restore from backup 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

Low server FPS/tick rate

See the Performance Guide for detailed optimization steps. Quick fixes:

• Reduce player count
• Remove resource-heavy mods
• Switch to a lighter scenario
• Schedule regular restarts

💡 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 | Server Logs | Automatic Backups

If you need help, join our Discord.