Server Troubleshooting - Valheim-Modding/Wiki GitHub Wiki
Dedicated Server Troubleshooting
This is a collection of common problems and solutions for not working modded dedicated servers.
TL;DR
- Make sure BepInEx loads. To verify this, shut down the server, delete the log file under
BepInEx/LogOutput.log
and restart. If no log is generated, then no mods have been loaded on the server. - If you use a server host and there is a BepInEx toggle somewhere, make sure to turn it on. If there is not a BepInEx toggle, but one for Valheim Plus you must turn that on. If you do not want to use the V+ mod, delete the ValheimPlus.dll or install Valheim Minus.
- Some mods have to be installed on the server to work. Check that server-side mods are installed on your server.
- If you start from R2MM/TMM you need to edit the
start_headless_server.bat
inside the Steam Valheim Dedicated Server folder and append%*
at the line where the server is launched.
Failed to Connect
If you get this error window, it probably means you could not reach the server. Make sure the server is running. Some server host will reassign your URL/IP address on game updates, make sure you are connecting to the right one. If you switched between crossplay and non-crossplay, Valheim sometimes remembers this and wants to connect to the old server. Remove the server from your recent connection list in-game and add it again to refresh it.
Make sure BepInEx is up to date. Game updates can occasionally break the BepInEx pack, and using the wrong version will cause the server to crash on startup. It can be downloaded from here BepInExPack Valheim. Do not use the BepInEx release from GitHub as it is not configured to work with Valheim.
BepInEx/Mods are not Starting
Many mods only need to be enabled on the client but some have to be installed on the server to synchronize configs or perform a version check. If you were able to connect with some client mods installed, it does not imply that mods have been loaded on the server. To tell if a mod has loaded on a server, check for a log file at BepInEx/LogOutput.log
. If this file does not appear, BepInEx has not loaded. If it does appear, be sure that the file is up-to-date by either looking at the last modification time or shutting the server down, deleting the file and rebooting the server to generate a new file. By default, the log file is overwritten on every successful startup.
If you do have the server log file you will see lines such as [Info : BepInEx] Loading [ModName 1.0.0]
for every mod that was successfully loaded. You can compare your client an server log files in a text editor (such as VSCode or Notepad++) to quickly identify differences. As a reminder, client-only mods do not need to be installed on a server (If using Thunderstore check the mod tags). If you see errors in your log file consult the client troubleshooting guide for more information.
Jotunn Information Pop-up
If you get this pop-up you were able to reach the server but there was a mod mismatch. This specific pop-up will only appear if you have a Jotunn mod installed, but does not always mean a mod using Jotunn has failed the connection attempt. Any failed connection by any mod can trigger this window. This pop-up can sometimes give you specific advice on how to fix your mod installation. If the remote version list is empty it is very likely BepInEx is not starting on your server. Follow the steps below to ensure BepInEx is starting:
Externally Hosted
Many server host support mods, but require you to toggle on a setting for the BepInEx mod loader. You may have added your mod files to the server but they will not start unless this toggle is on. A common issue with some Valheim server hosts is that ValheimPlus must to be enabled in order to start BepInEx. Even if BepInEx is manually installed this can be the case. If you have a web interface and a V+ switch, make sure to turn it on and restart the server. If you do not want to run V+ you can delete the ValheimPlus.dll
or install Valheim Minus. This is no offense to the ValheimPlus mod itself but the host companies, nobody should be forced to use a mod they do not want.
Self-Hosted
If you are hosting your own server make sure you have correctly installed BepInEx. The BepInEx pack comes with multiple files (in addition to the BepInEx folder) that must be installed at the top level of your server to work. For docker containers you may need to edit some of the server parameters in your UI. Many containers support BepInEx and can simply be toggled on and it will be installed for you.
Thunderstore Mod Manager (or r2modman)
The Valheim script to start a server cuts off all additional parameters set by the mod managers. Edit the start_headless_server.bat
inside the Steam Valheim Dedicated Server folder and append %*
at the line where the server is launched:
Be aware that the mod manager uses the same folder location for both the server and client when hosted from the same machine by default. If you use the mod manager to launch both (the client and server) you may run into issues with some mods. If you encounter issues using the mod manager for your server try doing a manual mod installation for your server.
Blackscreen After Connection Attempt
This can mean a mod uses an outdated ServerSync version internally. You can try to use the ServerSyncFix by Jere, which patches and writes the likely trouble mods to your console or log file. Be aware that this is only a short term workaround, the causing mods are no longer supported by their authors and could break at any time. Please read that mod description for more information on this issue.
Specific Valheim Server Hosts
No information at this time.