We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Valheim server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
Valheim guide

How to Install BepInEx Mods on a Valheim Dedicated Server

By the ChicagoServers team · Updated · 5 min read

To mod a Valheim server you turn on BepInEx for the server, start it once so it creates its folders, then add each mod's .dll so it ends up in BepInEx/plugins. On ChicagoServers that is the Load mods (BepInEx) field on the Startup tab plus the Mods tab. Valheim does not sync mods to players, so anything that changes gameplay also has to be installed on every client at the same version.

This guide covers the BepInExPack Valheim loader from Thunderstore (version 5.4.2360 at the time of writing), the difference between server-side, client-side and both-sides mods, and how to diagnose the failures that come up most. Checked 2026-11-01, after the Valheim 1.0 release.

Quick answer
  • On ChicagoServers, turn on Load mods (BepInEx) on the Startup tab, click Save startup, add mods on the Mods tab, then Restart.
  • Mods live in BepInEx/plugins; their config files appear in BepInEx/config; the log is BepInEx/LogOutput.log. You can browse all of these on the Files tab.
  • Check each mod's page: it is server-side, client-side or both. Mismatched sets are the top cause of "can't connect".
  • Install shared libraries (such as Jotunn) and keep every mod at the same version on server and clients.
  • After a major Valheim update, wait for mod authors to release compatible builds and re-add mods in small batches.
On this page
  1. Which mods need to be where
  2. Step 1: turn on BepInEx for the server
  3. Step 2: add mods one at a time
  4. Step 3: make players match the server
  5. Common failures and what they usually mean
  6. Frequently asked questions

Which mods need to be where

Every Valheim mod falls into one of three groups, and its Thunderstore or Nexus page should say which:

  • Server-side only. Runs on the server and players need nothing. These are the safest option, especially for a crossplay server.
  • Client-side only. Cosmetic or interface mods that each player installs for themselves. The server does not need them.
  • Both sides. Content and gameplay mods. The server and every player need the same mod at the same version, and some enforce a strict match and kick clients that differ.

Step 1: turn on BepInEx for the server

The loader most Valheim mods expect is the BepInExPack_Valheim package by denikson on Thunderstore. It is BepInEx 5 with Valheim-specific changes (a preconfigured BepInEx.cfg and a patched preloader). On ChicagoServers you do not copy loader files or edit start scripts yourself; you switch it on in the panel. A clean, unmodified server gives the fewest surprises.

  1. Open the Startup tab

    Sign in at panel.chicagoservers.co, open your server, then the Startup tab, and turn on Load mods (BepInEx).

  2. Save and restart

    Click Save startup, then Restart at the top of the page. On first run BepInEx creates BepInEx/config and BepInEx/LogOutput.log, which you can see on the Files tab.

  3. Confirm the loader attached

    Valheim has no server console, but the Console tab shows the server's output. Seeing BepInEx messages there, or a LogOutput.log in the BepInEx folder, confirms the loader attached. If not, open the Troubleshoot tab.

The Valheim server hosting page lists what is included, such as a one-click BepInEx installer, free server backups and SFTP file access.

Step 2: add mods one at a time

  1. Make a backup: open the Backups tab, choose World and settings (it includes mods and configs) and click Back up now.
  2. Download the mod from Thunderstore (or Nexus). Read its description for required dependencies and for whether it is server-side, client-side or both.
  3. Open the Mods tab and install the mod there. Install any dependencies first. A library called Jotunn is the one people most often forget.
  4. If a mod is not offered on the Mods tab, click Stop, then on the Files tab upload its .dll files into BepInEx/plugins (or use SFTP for big uploads). Subfolders are fine, and a mod's whole plugins folder can be copied as is. For a .zip, right-click it and choose Extract here, then delete the zip.
  5. Click Restart (or Start) and read the Console tab output, plus BepInEx/LogOutput.log on the Files tab, for the plugin list and any errors.
  6. Add the next mod only when the first one loads cleanly.

After a mod's first run it writes a config file into BepInEx/config, one per mod. To edit it, Stop the server, open the file on the Files tab (click a text file to open the editor), change it and Save (or Ctrl+S), then Start again. Some mods push their configuration from the server to players; the mod's page says which. For mods that do not, send the same config file to your players.

Step 3: make players match the server

Players install the same BepInExPack version and the same mods. The easiest route is a mod manager such as r2modman, Thunderstore Mod Manager or Gale: create a profile, install the same mods at the same versions, and launch from the manager. Exporting the profile as a code lets the whole group import an identical set. On Linux clients, the Thunderstore page tells you to set the Steam launch option to ./start_game_bepinex.sh %command%.

Keep a short list in your Discord of exactly which mods and versions the server runs. Valheim does not sync mods itself, so this list is your only source of truth.

Common failures and what they usually mean

SymptomLikely cause and fix
No BepInEx messages at startupLoad mods (BepInEx) is off on the Startup tab (turn it on, Save startup, Restart), or the loader did not start. Check the Console output and the Troubleshoot tab.
Mod missing from the plugin listIt is not in BepInEx/plugins, was built for a different Valheim version, or is a client-only mod.
Missing dependency errorThe log names the missing mod by internal ID, for example com.jotunn.jotunn. Install it.
Players cannot connect or are kickedMod set or version differs between server and client. Compare lists and config files.
Server crashes after adding a modRemove the most recent mod on the Mods tab (or delete it from BepInEx/plugins on the Files tab), restart, and repeat until it boots. A backup from before the problem can be put back on the Backups tab.
Trouble after a Valheim updateWait for updated mod versions. BepInEx and mods are built against specific game builds. Update the server first with Update now on the Steam update bar.

Frequently asked questions

Where do mods go on a Valheim dedicated server?

In BepInEx/plugins, inside the server's files. On ChicagoServers turn on Load mods (BepInEx) on the Startup tab, install mods on the Mods tab (or upload them to BepInEx/plugins on the Files tab) and restart. Start once first so BepInEx creates its folders and log.

Do players need the same mods as the server?

For any mod that runs on both sides, yes, at the same version. Server-side-only mods need nothing on the client, and client-side-only mods need nothing on the server. Always check the mod's page.

How do I tell if BepInEx is working on my server?

BepInEx messages appear in the server output on the Console tab at startup, and BepInEx/LogOutput.log is created listing loaded plugins. If neither appears, check that Load mods (BepInEx) is on in the Startup tab and that you restarted.

Can console players join a modded Valheim server?

Only if every mod is server-side only, because console players cannot install mods. Any mod required on the client will lock them out.

We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Valheim server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!