---
title: "How to Install and Enable BepInEx on a Valheim Server"
description: "Quick guide to installing and enabling the BepInEx framework on your Winheberg Valheim server via the Software Changer tool."
category: jeux
subcategory: valheim
icon: tabler:file-text
date: 2026-08-11
author: Winheberg
slug: "install-bepinex-valheim"
order: 79
image: /statics/images/docs/en/gaming/valheim/install-bepinex-valheim.webp
tags: [Valheim, BepInEx, Tutorial, Server]
keywords: [install bepinex valheim, enable bepinex valheim, winheberg software changer, bepinexpack valheim, server bepinex setup]
link_fr: "/docs/valheim/installer-bepinex-valheim"
---

## Context

**BepInEx** is the essential framework required to run custom logic and extend capabilities on your Valheim server. On the Winheberg panel, installing and enabling BepInEx takes only a few seconds using the **Software Changer** tool.

This guide walks you through the step-by-step process of activating BepInEx on your server.

## Prerequisites

- An active Valheim server on your [Winheberg panel](https://panel.winheberg.com).

## Step 1: Stop the Server

To ensure a clean installation and prevent file conflict errors, your server must be completely shut down before changing software versions.

1. Log in to your [Winheberg panel](https://panel.winheberg.com).
2. On your server dashboard, click the red **Stop** button in the top right corner.
3. Wait until the server status shows **Offline**.

## Step 2: Enable BepInEx via Software Changer

1. In the left sidebar menu, scroll down to the **CONFIGURATION** section.
2. Click on **Software Changer**.
3. Locate the **Valheim BepInEx** entry in the software list.
4. Choose your installation preference:
   - Select **NOT DELETE FILES** to install BepInEx while preserving all your existing server data (world files, configurations).
5. Click the green **INSTALL** button.

The panel will automatically download and deploy the BepInEx framework onto your server.

## Step 3: Start the Server to Complete Setup

1. Go back to the **Console** tab in the left menu.
2. Click the green **Start** button.
3. Observe the startup logs: BepInEx will automatically initialize as the server boots up.

Your Valheim server is now running on the BepInEx framework!

## Troubleshooting

### ❌ Installation gets stuck
- **Server Status:** Ensure the server was completely turned off (**Offline**) before clicking **INSTALL**. If the server was running during installation, the process might fail.

### ❌ Server fails to launch after switching to BepInEx
- **Option Check:** If you accidentally selected a wipe option, check the **Files** tab to confirm system files are intact. You can re-run the installation via **Software Changer** at any time.

## Best Practices

- **Always select "NOT DELETE FILES":** Unless you intend to perform a complete server wipe, keep this option selected to protect your world save.
- **Create a Backup:** Before switching software builds via Software Changer, create a precautionary backup from the **Backups** tab.

## Need Assistance?

If you run into any issues while setting up BepInEx, our technical team is here to assist you. Submit a support ticket through [Winheberg Support](https://billing.winheberg.com/login). 🎮