Valheim Server Troubleshooting
Fix common Valheim dedicated server issues: connection problems, incompatible versions, world not loading, lag, and crossplay errors.
Wiki team
Valheim Server Troubleshooting
Running into issues with your Valheim server? This guide covers the most common problems and their solutions.
Connection Issues
"Could Not Connect" / Server Unreachable
Symptoms: Players cannot connect to the server at all.
Solutions (check in order):
- Is the server running? Check the HostedGG dashboard — the status should show "Running"
- Correct IP and port? Double-check the IP:Port shown in your dashboard Console tab
- Include the port: Always use the format
IP:PORT(e.g.,123.45.67.89:2456) - Server still starting? After a restart, Valheim can take 1-3 minutes to fully load the world
- Check server console for RED error messages that might indicate a crash
"Disconnected" Immediately After Joining
Symptoms: Player connects briefly, then gets kicked.
Solutions:
| Possible Cause | Fix |
|---|---|
| Wrong password | Re-enter the correct password |
| Password contains server name | Change the password (Valheim requires password ≠ server name) |
| Mod version mismatch | Ensure server and client have identical mod versions |
| Server is saving | Wait 30 seconds and try again |
| Banned | Check bannedlist.txt in File Manager |
"Incompatible Version"
Symptoms: Error message showing different version numbers.
This happens when:
- The game updated but the server hasn't restarted yet
- You're running an older/newer version than the server
- Crossplay with different platform update schedules
Solutions:
- Restart the server — This usually triggers an auto-update
- Check for game update — Verify your local game is up to date on Steam
- Platform desync — After a patch, Steam/Xbox/Game Pass may update at different times. Wait for all platforms to update
- Force update — In the HostedGG dashboard, use the reinstall option to force the latest version
Server Not Showing in Server Browser
Symptoms: Server works via IP but isn't searchable.
Solutions:
- Wait 10-15 minutes — Server registration with the master server list takes time
- Check "Public" setting — Must be enabled for server browser listing
- Server name too long? — Keep it under 64 characters
- Use Join IP instead — The server browser is unreliable. Always share your IP:Port directly
World & Save Issues
World Not Loading / Stuck on "Loading..."
Solutions:
- Check world file size — Open File Manager, navigate to the worlds folder. Files should be more than a few KB
- World name mismatch — The World Name setting must exactly match the
.fwl/.dbfilenames (case-sensitive) - Corrupted save — Restore from a backup (see Backups Guide)
- Disk full — Check storage usage in the dashboard
Progress Lost / World Reset
Possible causes:
- World Name was changed — The server created a new world. Revert to the old World Name
- Files deleted — Check if world files still exist in the File Manager
- Restore point — Use a backup to recover
Buildings Disappeared
This is usually caused by one of:
- Structure support collapse — Buildings can collapse if the support structure is broken
- Raid damage — A raid event destroyed structures while nobody was defending
- Terrain changes — Terraforming too close to structures can break them
Unfortunately, structure destruction isn't reversible without a backup restore.
Performance Issues
General Lag / Rubberbanding
See our full Performance Optimization Guide. Quick fixes:
- Restart the server — Clears memory and resets state
- Check player spread — Players in many different biomes increases load
- Remove dropped items — Admin command:
removedrops - Check for mod errors — View
BepInEx/LogOutput.logfor error spam - Upgrade your plan — If consistent, you may need more RAM
Periodic Freezes (Every 30 Minutes)
This is normal. Valheim freezes briefly during world saves. The default save interval is 1800 seconds (30 minutes).
To make freezes shorter (but more frequent):
- Open Settings in the dashboard
- Reduce the Save Interval to 900-1200 seconds
High RAM Usage
Valheim RAM usage grows over time, especially with:
- Large explored areas
- Heavy terraforming
- Many build pieces
- Multiple mods
Solutions:
- Schedule regular server restarts (daily recommended)
- Avoid excessive terraforming
- Remove unused mods
Mod Issues
Mods Not Loading After Installing BepInEx
- Verify
winhttp.dllexists in the server root directory - Check
doorstop_config.inihasenabled=true - Look at
BepInEx/LogOutput.logfor loading errors - Make sure you installed the Valheim-specific BepInEx pack, not the generic one
Server Crashes After Adding a Mod
- Remove the last mod you installed
- Restart the server
- If it works, the removed mod is incompatible
- Check if the mod requires specific dependencies (many mods need other mods to work)
- Verify mod compatibility with your Valheim version
"NullReferenceException" in BepInEx Logs
This usually means:
- A mod is outdated and not compatible with the current Valheim version
- A required dependency mod is missing
- Two mods are conflicting
Solution: Update all mods, or remove mods one at a time to find the culprit.
Crossplay Issues
Join Code Not Appearing
- Ensure crossplay is enabled in Settings
- Wait 2-3 minutes after server start for PlayFab registration
- Check the console — The code appears as:
Session "ServerName" with join code XXXXXX registered - Restart the server if the code doesn't appear after 5 minutes
Xbox Player Can't Connect
See our detailed Crossplay Guide. Quick checks:
- Both players on same Valheim version?
- Join Code entered correctly (case-sensitive)?
- Password doesn't contain special characters?
Admin Issues
Admin Commands Not Working
- Check
adminlist.txtcontains your correct Steam64 ID - Rejoin the server after adding yourself to the admin list
- Type
devcommandsin the console before using admin commands - Verify you're using the correct command syntax
Can't Ban a Player
- You need the player's Steam64 ID, not their display name
- Add the ID to
bannedlist.txtin the File Manager - Or use the in-game command:
ban [steamID] - The player won't be removed until they disconnect or you kick them first
Emergency Recovery
If your server is completely broken:
Option A: Restart and Wait
- Stop the server from the dashboard
- Wait 30 seconds
- Start the server
- Wait 3 minutes for full world load
Option B: Restore from Backup
- Go to the Backups tab
- Select the most recent working backup
- Click Restore
- Restart the server
Option C: Clean Reinstall (Last Resort)
- Download your world files first (File Manager → worlds folder)
- Use the Reinstall option in the dashboard
- Re-upload your world files
- Reconfigure settings
Warning: A reinstall removes all server files including mods and configs. Always back up your world and config files first.
Still Need Help?
If none of these solutions work:
- Join our Discord: discord.gg/xGn3D5drZt — Our team and community can help debug
- Submit a support ticket: HostedGG Support
- Check our other Valheim guides:
Related Blog Posts
Related Articles
Help verify this page
Tested this recently? Send a quick accuracy signal for editors.
Help improve HostedGG
Know this game? Join our community of contributors.
Discussion
Sign in to join the discussion.
Loading discussion...