---
title: "Comment installer et activer BepInEx sur un serveur Valheim ?"
description: "Guide rapide pour installer et activer le framework BepInEx sur votre serveur Valheim Winheberg via l'outil Software Changer."
category: jeux
subcategory: valheim
icon: tabler:file-text
date: 2026-08-11
author: Winheberg
slug: "installer-bepinex-valheim"
order: 79
image: /statics/images/docs/fr/gaming/valheim/installer-bepinex-valheim.webp
tags: [Valheim, BepInEx, Tutoriel, Serveur]
keywords: [installer bepinex valheim, activer bepinex valheim, software changer winheberg, bepinexpack valheim, configurer bepinex serveur]
link_en: "/en/docs/valheim/install-bepinex-valheim"
---

## Contexte

**BepInEx** est le framework incontournable pour exécuter du code personnalisé et étendre les fonctionnalités de votre serveur Valheim. Sur le panel Winheberg, l'installation et l'activation de BepInEx se font en quelques secondes grâce à l'outil **Software Changer**.

Ce guide vous explique la procédure pas à pas pour activer BepInEx sur votre serveur.

## Prérequis

- Un serveur Valheim actif sur votre [panel Winheberg](https://panel.winheberg.com).

## Étape 1 : Arrêter le serveur

Pour garantir une installation propre et éviter tout conflit d'écriture, votre serveur doit impérativement être éteint avant de changer de version.

1. Connectez-vous à votre [panel Winheberg](https://panel.winheberg.com).
2. Sur le tableau de bord de votre serveur, cliquez sur le bouton rouge **Stop** en haut à droite.
3. Attendez que le statut de votre serveur passe sur **Offline**.

## Étape 2 : Activer BepInEx via le Software Changer

1. Dans le menu latéral de gauche, descendez jusqu'à la section **CONFIGURATION**.
2. Cliquez sur **Software Changer**.
3. Dans la liste des logiciels disponibles, repérez la ligne **Valheim BepInEx**.
4. Sélectionnez votre option d'installation :
   - Choisissez **NOT DELETE FILES** pour installer BepInEx tout en conservant l'intégralité de vos données actuelles (monde, configurations).
5. Cliquez sur le bouton vert **INSTALL**.

Le panel va automatiquement télécharger et déployer l'architecture BepInEx sur votre serveur.

## Étape 3 : Démarrer le serveur pour finaliser l'installation

1. Retournez dans l'onglet **Console** dans le menu de gauche.
2. Cliquez sur le bouton vert **Start**.
3. Observez les logs de démarrage : BepInEx va s'initialiser automatiquement au lancement du serveur.

Votre serveur Valheim tourne désormais sous l'environnement BepInEx !

## En cas de problème

### ❌ L'installation reste bloquée
- **Statut du serveur :** Assurez-vous que le serveur était bien totalement éteint (**Offline**) avant de cliquer sur **INSTALL**. Si le serveur était en cours d'exécution, le processus peut échouer.

### ❌ Le serveur ne se lance pas après le passage sous BepInEx
- **Vérification de l'option :** Si vous avez sélectionné une option de réinitialisation par erreur, vérifiez dans l'onglet **Files** que les fichiers système du jeu sont bien présents. Vous pouvez relancer l'installation via le **Software Changer** à tout moment.

## Bonnes pratiques

- **Sélectionnez toujours "NOT DELETE FILES" :** Sauf si vous souhaitez effectuer un nettoyage complet de votre serveur, conservez cette option pour protéger votre carte de jeu.
- **Sauvegardez votre serveur :** Avant tout changement de version via le Software Changer, effectuez une sauvegarde préventive depuis l'onglet **Backups**.

## Besoin d'aide ?

Si vous rencontrez le moindre problème lors de la mise en place de BepInEx, notre équipe technique reste à votre disposition. Ouvrez un ticket d'assistance depuis le [support Winheberg](https://billing.winheberg.com/login). 🎮