
Mods can turn Valheim into a whole new game: new biomes, creatures, gear, building pieces and quality-of-life fixes. Almost all of them run on BepInEx, the mod loader for Valheim. Here's how to install mods on your dedicated server, which ones also need to be on your players' PCs, and how to keep everyone's versions in sync.
Make sure BepInEx is installed on the server (it comes pre-installed on SkailarHost). Stop the server, upload each mod's folder or .dll into BepInEx/plugins, add its dependencies, then start the server and check the console. Settings appear in BepInEx/config after the first start. Mods that add content must be installed by every player too, at the same version, which is easiest with an r2modman profile code.
BepInEx is a plugin framework for games made in Unity. It starts with the game and loads every plugin (a .dll file) it finds in its plugins folder. Nearly every Valheim mod on Thunderstore and Nexus Mods is a BepInEx plugin.
For Valheim, use BepInExPack_Valheim from Thunderstore, not the generic BepInEx release. It comes set up for Valheim, and it's the version mod authors build and test against. It includes everything a dedicated server needs to load mods, including a start script for Linux servers.
This is where most modded servers go wrong. Not every mod belongs on the server, and some do nothing unless every player has them too.
| Kind of mod | Install it | Typical examples |
|---|---|---|
| Client only | Only on each player's PC | Minimaps, HUD and UI tweaks, camera and graphics mods |
| Server and client | On the server and every player | New items, creatures, recipes and building pieces, gameplay and balance changes |
| Server only | Only on the server | Admin and server management tools, logging and world tools |
The rule of thumb: if a mod adds something to the world (an item, a creature, a recipe, a building piece) or changes the rules, it goes on the server and on every player's PC. Most mod pages say where to install it, so read the description first. When in doubt, install it on both.
Many mods also sync their settings from the server to each player when they join, often with a "Lock Configuration" option. On those, the server's config file is the one that counts, so players can't give themselves different rules.
Open your server's files. If BepInEx is installed, you'll see a BepInEx folder next to the server files, with core, config and plugins folders inside. On SkailarHost, BepInEx comes pre-installed, so it's already there.
Installing it yourself somewhere else? Download BepInExPack_Valheim from Thunderstore and copy the contents of its BepInExPack_Valheim folder into the server's root folder, next to the valheim_server executable. On Linux, start the server with the included start_server_bepinex.sh so BepInEx actually loads.
Stop it from your game panel. BepInEx only loads plugins when the server starts, and changing files while it runs can corrupt configs.
On Thunderstore, use Manual Download on the mod's page to get a zip. Inside you'll find the plugin (.dll), a manifest.json, an icon and a readme, and sometimes extra folders for assets or translations. Nexus Mods downloads work the same way. Check that the mod has been updated for the current Valheim version.
Upload the mod into BepInEx/plugins with the file manager or over SFTP. Give each mod its own folder, like BepInEx/plugins/Author-ModName: BepInEx also looks inside subfolders, and you'll always know which files belong to which mod. If the mod ships with extra folders, keep them next to its .dll.
Thunderstore lists each mod's dependencies on its page. Many content mods need a library such as Jotunn. Install every dependency the same way. BepInExPack_Valheim is always one of them, and it's already installed.
Start the server and watch the console. BepInEx prints a line like Loading [ModName 1.2.3] for every plugin it finds, and the full log is saved to BepInEx/LogOutput.log. If a mod is missing from the list or shows red errors, see the troubleshooting section below.
After the first start, most mods create a config file in BepInEx/config, usually named after the mod, like author.modname.cfg. Stop the server, edit the file in the panel's file editor, save it and start the server again.
BepInEx/
├── config/ ← settings (.cfg), created on first start
├── plugins/ ← your mods, one folder each
│ ├── ValheimModding-Jotunn/
│ └── Author-ModName/
└── LogOutput.log ← check this when a mod won't loadEvery player needs the same server-and-client mods, at the same versions as the server. The easiest way is a mod manager such as r2modman or the Thunderstore Mod Manager:
The same profile is a handy way to fill the server, too: open the profile folder from r2modman's settings and copy the mods from its BepInEx/plugins folder, leaving out the client-only ones.
Turn off automatic mod updates
If one player's mod manager updates a mod and the server doesn't, that player can't join. Update mods on purpose: the server first, then share a fresh profile code.
A big Valheim patch can break mods until their authors release a fix. Before you update a modded server:
BepInEx folder.LogOutput.log after a restart, BepInEx itself isn't running. Check it's installed in the server's root folder and that the server starts through BepInEx.plugins, start again, and read the log to see what it needed.If you remove a mod that adds items, creatures or building pieces, everything it added disappears from your world, including what's in chests and players' bases. Take a backup before you remove one.
Our Valheim server hosting comes with BepInEx pre-installed, so you can start uploading mods the moment your server is live. Manage files and configs from the panel or over SFTP, upload your existing world, and take a manual backup before big mod changes on top of the automatic daily ones. Plans start at $4.99/month, and the most popular 10 GB plan handles 10–15 players. Mods use extra memory, so if a big mod list outgrows your plan, you can add RAM later without moving your world.
For any mod that adds content or changes gameplay, yes, at the same version as the server. Client-only mods are up to each player, and server-only mods need nothing on their side.
Xbox players can't install BepInEx mods, so they can only join if no mod on the server needs to be installed by players.
Both work. Thunderstore is the most popular source for Valheim mods and works with r2modman, which makes keeping everyone in sync much easier.
Yes. Some mods reload their settings live, but a restart is the only way to be sure the change is applied.
Valheim servers from $4.99/month, with BepInEx pre-installed, custom world uploads, daily backups and free DDoS protection.