Guides

How to Install Valheim Mods on Your Server with BepInEx

SkailarHost Team
November 15, 2026
7 min read
How to Install Valheim Mods on Your Server with BepInEx

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.

TL;DR

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.

What is BepInEx?

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.

Server mods, client mods, or both?

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 modInstall itTypical examples
Client onlyOnly on each player's PCMinimaps, HUD and UI tweaks, camera and graphics mods
Server and clientOn the server and every playerNew items, creatures, recipes and building pieces, gameplay and balance changes
Server onlyOnly on the serverAdmin 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.

How to install mods on your Valheim server, step by step

1. Check that BepInEx is installed

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.

2. Stop the server

Stop it from your game panel. BepInEx only loads plugins when the server starts, and changing files while it runs can corrupt configs.

3. Download the mod

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.

4. Upload it to BepInEx/plugins

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.

5. Add its dependencies

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.

6. Start the server and check the console

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.

7. Change the mod's settings

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 load

Set up your players with r2modman

Every 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:

  1. One person creates a profile with exactly the mods the server runs.
  2. In the profile settings, choose Export profile as code and share the code on your Discord.
  3. Everyone else imports the profile with that code from r2modman's profile screen and launches the game with Start modded.

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.

When Valheim updates

A big Valheim patch can break mods until their authors release a fix. Before you update a modded server:

  • Take a backup of your world and your BepInEx folder.
  • Check your mods' pages to see if they work with the new version. Library mods like Jotunn usually update first.
  • Update the server and every player together. Players on a different game version than the server can't join, mods or not.

Troubleshooting

  • "Incompatible version" when joining: the player is on a different Valheim version than the server, or a mod's version doesn't match. Many mods built on Jotunn check this for you and list the mods that don't match. Update so both sides have the same versions.
  • No mods load at all: if there's no 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.
  • One mod doesn't load: it's usually a missing dependency or a mod that hasn't been updated for the current game version. The log names it.
  • The server crashes after you add a mod: move the last mod you added out of plugins, start again, and read the log to see what it needed.
  • A mod does nothing: it may be a client-only mod installed on the server, or a server-and-client mod some players don't have.

⚠️ Removing a content mod

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.

Modded Valheim servers on SkailarHost

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.

FAQ

Do my players need the mods too?

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.

Can Xbox players join a modded server?

Xbox players can't install BepInEx mods, so they can only join if no mod on the server needs to be installed by players.

Thunderstore or Nexus Mods?

Both work. Thunderstore is the most popular source for Valheim mods and works with r2modman, which makes keeping everyone in sync much easier.

Do I need to restart after changing a config?

Yes. Some mods reload their settings live, but a restart is the only way to be sure the change is applied.

Start your modded Valheim server

Valheim servers from $4.99/month, with BepInEx pre-installed, custom world uploads, daily backups and free DDoS protection.

Tags

#Valheim#BepInEx#Mods#Thunderstore#Guides

Related Articles