Valheim server problems
Common Valheim server problems and how to fix them. Settings named here are on your Startup page, see Valheim settings.
My server does not show up in the server list
Section titled “My server does not show up in the server list”Why it happens: Valheim’s list is slow to add new servers, often 5 to 15 minutes after the server starts. It also stays hidden if Public Server (PUBLIC_SERVER) is off.
How to fix it:
- Wait until the status says Online, then wait about 15 minutes.
- On Startup, check Public Server is
1. Setting it to0hides the server on purpose. - Search for the exact Server Name (
SERVER_NAME). Use the Community tab. - If it is still missing, join by IP instead (see below).
How do I join by IP and port?
Section titled “How do I join by IP and port?”Why it happens: Valheim uses a game port and a query port. The query port is the game port plus one, and Steam’s server list uses it.
How to fix it:
- Find your address and port on the Network page.
- In Valheim, choose Join Game, then Join by IP, and enter
address:port. - If it does not work, some players report success with the port one number higher, since that is the query port Steam uses.
- To save it, in Steam open View, Game Servers, Favorites, add the address with the query port.
- If neither works, open a ticket and we will check the ports.
Server password rejected, or server will not start with a password
Section titled “Server password rejected, or server will not start with a password”Why it happens: Valheim needs a password of at least 5 characters. A password that is too short, or that looks like the server or world name, can stop the server from starting or being joined.
How to fix it:
- Stop the server.
- On Startup, set Server Password (
PASSWORD) to at least 5 characters, and different from your Server Name and World Name. - Start the server and read the Console.
- Players get “Incorrect password” if they mistyped it. Passwords are case sensitive.
Incompatible version, or “Incompatible version, server is running version …”
Section titled “Incompatible version, or “Incompatible version, server is running version …””Why it happens: Valheim clients and servers must be the same version. After a Valheim update, either side can be behind.
How to fix it:
- Restart the server so it can check for updates. Make sure Auto Update (
AUTO_UPDATE) is1. - Ask players to restart Steam so Valheim updates.
- If you use a Beta Branch (
SRCDS_BETAID), players must be on the same beta branch. Leave it blank for the normal version. - Modded servers: mods may need to update too. See the mod sections below.
Server will not start or crashes after a Valheim update
Section titled “Server will not start or crashes after a Valheim update”Why it happens: An update can break mods or leave a bad file during the download.
How to fix it:
- Read the last lines of the Console and see Server keeps restarting.
- For a modded edition, remove mods and test.
- Try a restart.
- If it fails, open a ticket with the Console text. Do not use Reinstall before backing up your world.
What is my world called and where is it saved?
Section titled “What is my world called and where is it saved?”Why it happens: The world name is set by World Name (WORLD), and the save is two files with that name.
How to fix it:
- The default is
Dedicated. Changing World Name loads a different world, or creates a new empty one if none matches. - In Files, world files end in
.dband.fwl. They are normally under aworlds_localfolder inside the game’s config folder. Turn on hidden files or search if you cannot see it. - To move a world from single player, upload both files with the same name. Set World Name to that name.
I changed World Name and my world vanished
Section titled “I changed World Name and my world vanished”Why it happens: The server loaded a new world because no files match the new name. The old world is still there.
How to fix it:
- Stop the server.
- Set World Name back to the old name on Startup.
- Start the server. Your original world loads again.
How do I back up or restore my world?
Section titled “How do I back up or restore my world?”Why it happens: Valheim keeps its own automatic backups, and you can add panel backups.
How to fix it:
- Use panel Backups before big changes.
- Valheim’s own backups are controlled by Backup Interval, Backup Count, Backup Shorttime and Backup Longtime on Startup.
- To restore, stop the server, and put the
.dband.fwlfiles back in the world folder. Or restore a panel backup.
Progress lost after a crash
Section titled “Progress lost after a crash”Why it happens: Valheim only saves on an interval. Anything since the last save is lost if the server stops uncleanly.
How to fix it:
- Lower Backup Interval (
BACKUP_INTERVAL, in seconds) if you want more frequent saves. The default is 1800. - Use Stop, not Kill.
- Restore from a backup if the world is corrupt.
How do I set admins?
Section titled “How do I set admins?”Why it happens: Valheim admins are a list of Steam IDs in a text file. There is no admin variable on Startup.
How to fix it:
- Find each player’s SteamID64.
- In Files, look for
adminlist.txt. It is usually in the folder that contains theworlds_localfolder, not inside it. - Add one SteamID64 per line, save, and restart the server. In game, players can see their ID by pressing F2.
- If the file is missing, create it. If you cannot find the folder, open a ticket.
Crossplay: players on Xbox or Game Pass cannot join
Section titled “Crossplay: players on Xbox or Game Pass cannot join”Why it happens: Crossplay must be on for the server. The setting is Enable Crossplay (ENABLE_CROSSPLAY).
How to fix it:
- Stop the server.
- On Startup, set Enable Crossplay to
1and save. - Start the server and give it several minutes.
- The default is different per edition: it is
1for standard Valheim and0for BepInEx and Plus Mod. If crossplay still fails, open a ticket.
Mods do not load (BepInEx)
Section titled “Mods do not load (BepInEx)”Why it happens: BepInEx is the mod loader. Mods live in its folders, and every player must also have the same mods for most mods.
How to fix it:
- Your server must be the BepInEx edition, chosen at checkout.
- Upload mods with Files into the BepInEx
pluginsfolder (usuallyBepInEx/plugins). - Check the Console for lines about BepInEx loading and for errors from each mod.
- To install a whole modpack, put its Dependency String in ModPack (
V_MODPACK) on Startup. Changing it needs a server reinstall, so back up first. - If the modpack updates, you must update the string yourself.
Players get kicked or cannot join with mods (client and server mismatch)
Section titled “Players get kicked or cannot join with mods (client and server mismatch)”Why it happens: Many mods must be the same version on the server and on every player. Mismatched mods cause errors or kicks.
How to fix it:
- Make a list of the mods and exact versions on the server.
- Have players install the same versions. A mod manager profile that matches the server is the easiest way.
- Remove the mod you suspect and test.
- We cannot promise that any mod works. Ask the mod’s author for support.
Valheim Plus settings do not apply
Section titled “Valheim Plus settings do not apply”Why it happens: Valheim Plus reads its own config file, which is usually valheim_plus.cfg in the BepInEx config folder. Players also need Valheim Plus installed.
How to fix it:
- Stop the server.
- Edit the Valheim Plus config file in Files.
- Start the server. Check the Valheim Plus documentation for which options players must match.
- Check the Console for config errors, such as bad indentation.
Server is laggy or has rubber-banding
Section titled “Server is laggy or has rubber-banding”Why it happens: Valheim servers slow down with big worlds, many built structures, or a low connection to a player.
How to fix it:
- Restart the server on a schedule: see Schedules.
- Reduce very large builds and dropped items.
- If the Console shows “Out of memory: true”, see Out of memory.
Still stuck?
Section titled “Still stuck?”Open a ticket or ask on Discord. See Contact support.