Sons of the Forest Troubleshooting
This guide covers common issues with Sons of the Forest dedicated servers hosted with Legion Hosting. For initial setup, configuration, and connection instructions, see the Sons of the Forest Dedicated Server Setup Guide. Your server is managed through GPanel.
Server Crashes on Startup
Symptom: The server starts but immediately stops or crashes before players can connect.
Possible causes and solutions:
- Corrupted config file: Check that
dedicatedserver.cfgis valid JSON. A missing comma or mismatched quote will prevent the server from loading. Use a JSON validator to verify and correct any syntax errors. - Corrupted save file: If the server crashes after loading a save, the save may be corrupt. Try switching to a different
SaveSlotin the config to test with a fresh world. If the server starts successfully on a new slot, the original save file is likely the issue. - Server update required: Use GPanel to force a server update/reinstall to ensure the latest version is installed.
- Port conflict: Verify that the ports in
dedicatedserver.cfgmatch the ports assigned to your server. Check the Network tab in GPanel for your assigned port numbers.
High Memory Usage
Symptom: The server uses excessive RAM, causing slowdowns or crashes after extended uptime.
- Sons of the Forest dedicated servers have a higher memory footprint than most games. Make sure your plan has sufficient RAM for the number of players you intend to support.
- Restarting the server periodically (e.g., once per day via a scheduled restart in GPanel) can reclaim memory and improve performance.
- Reducing
MaxPlayersindedicatedserver.cfglowers the server's memory requirements. - Large or long-running worlds with many structures will consume more memory over time. Consider starting a fresh save slot if memory usage becomes unmanageable.
Tip: You can set up a scheduled task in GPanel to automatically restart your server at a specific time each day, helping to prevent memory-related issues.
Players Cannot Connect
Symptom: Players attempt to join but receive a connection error or timeout.
- Server not fully started: Wait 2–3 minutes after clicking Start in GPanel before attempting to connect. The server takes time to initialize.
- Wrong port: Confirm players are connecting to the correct IP and query port. Check the Network tab in GPanel for your assigned connection details.
- Config port mismatch: The
ServerPort,ServerQueryPort, andBlobSyncPortvalues indedicatedserver.cfgmust match the ports assigned in GPanel. If they do not match, the server will not be reachable. - Password mismatch: If
ServerPasswordis set, ensure all players are entering the exact password including correct capitalisation. - Server not visible in browser: Ensure
LanOnlyis set tofalseindedicatedserver.cfgif you want the server listed publicly. Even with this set correctly, it can take several minutes after startup for the server to appear in the Steam server browser. - Game version mismatch: All players must be running the same version of Sons of the Forest as the server. If the game recently updated, ensure the server has also been updated via GPanel.
- Steam server list delay: After starting or restarting your server, it can take up to 5 minutes for it to appear in the Steam server browser. Try adding it as a favourite using the direct connect method described in the setup guide.
World Not Saving
Symptom: Player progress or world changes are lost after a server restart.
- Confirm
SaveIntervalis set to a reasonable value indedicatedserver.cfg(e.g.,600for 10 minutes). - Avoid forcibly stopping the server process — always use the Stop button in GPanel to allow the server to write a clean save before shutting down.
- Verify the
SaveSlotvalue has not been changed between restarts. Changing the slot will load a different world, which may appear as if progress was lost. - Check that the
saves/directory on your server is not empty or corrupted. You can inspect save files via SFTP or the GPanel file manager.
Save File Corruption
Symptom: The server crashes when loading a specific save slot, but works fine on other slots.
- Switch to a different
SaveSlotindedicatedserver.cfgto confirm the issue is save-specific. - If you have a backup of the save, restore it via SFTP by replacing the contents of the affected slot folder (e.g.,
saves/Slot1/). - If no backup is available, you may need to start fresh on that save slot. Delete the contents of the slot folder and restart the server to generate a new world.
- To prevent future data loss, periodically back up your
saves/directory via SFTP.
Prevention: Always use the Stop button in GPanel rather than killing the server process. Abrupt shutdowns are the most common cause of save corruption.
Related Articles
- Sons of the Forest Dedicated Server Setup Guide — Configuration, connection, and save management
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
Need Further Help?
If you are still experiencing issues after following this guide, please open a support ticket and include:
- A description of the issue and when it started
- Your server ID or IP address from GPanel
- Any relevant error messages from the server console or log files
- Whether the issue occurs on a fresh save slot or only on an existing one