Skip to main content

​
How to Install BepInEx Mods on Valheim Server

BepInEx is the modding framework for Valheim that allows you to install mods and enhance your Viking survival experience. This guide shows you how to install BepInEx and mods on your Valheim server.
Always backup your server before installing mods.

​
Installing BepInEx on Your Server

  1. Login to your game control panel
  2. Stop your server
  3. Create a backup of your server
  4. Download BepInEx_x64 (latest version)
  5. Extract the ZIP file
  6. Upload all extracted files to your server’s root directory via File Manager
  7. Start your server once to generate configuration files
  8. Stop the server - BepInEx is now installed

​
Installing Mods on Your Server

  1. Download mods from Nexus Mods or Thunderstore
  2. Extract the mod files (usually .dll files)
  3. Upload the .dll files to BepInEx/plugins/ folder via File Manager
  4. Restart your server
Note: Some mods require client installation. Check the mod description to see if players need to install it locally. Valheim Plus - Comprehensive gameplay overhaul with customizable features
Equipment and Quick Slots - Additional equipment slots and hotkeys
Craft From Containers - Auto-craft from nearby chests
Build Camera - Better camera for construction
Server devcommands - Admin commands and tools For a complete list, see our Popular Viking Mods guide.

​
Client Installation

Some mods require players to install them locally:
  1. Install BepInEx on local Valheim installation
  2. Download and install the same mods as the server
  3. Ensure mod versions match exactly
  4. Launch Valheim through Steam

​
Frequently Asked Questions

It depends on the mod type. Server-side mods (like admin tools) only need server installation, while gameplay mods usually require all players to have matching installations.
Yes, most mods can be added to existing worlds. However, always create a backup first as some mods may cause compatibility issues with existing save data.
Check the BepInEx log files for error messages. Common causes include mod conflicts, missing dependencies, or incompatible mod versions. Remove mods one by one to identify the problem.
Download the latest version of the mod and replace the old files in the plugins folder. Always check the mod’s changelog for any configuration changes or new requirements.
It’s recommended to use only one mod manager to avoid conflicts. Choose either r2modman or Thunderstore Mod Manager and stick with it for consistency.
Removing mods from an active server can cause issues if the mod has modified world data. Always test mod removal on a backup first and inform players of any required changes.
Check the BepInEx/LogOutput.log file for error messages, remove recently installed mods one by one to identify conflicts, and verify all mod files are in the correct directories.
Ensure all players have the same client-side mods installed, check that server-only mods don’t require client installation, and verify mod versions match between server and clients.
Monitor server performance after installing each mod, as some mods can significantly impact performance. Consider reducing player count or upgrading server resources if needed.
Need help? Join our Discord community or contact support.
⌘I