[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-en-install-bepinex-valheim":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":20,"docGroup":26,"docGroupIcon":26,"link_fr":27,"bodyHtml":28},"\u002Fdocs\u002Fen\u002Fgaming\u002Fvalheim\u002Finstall-bepinex-valheim","install-bepinex-valheim","How to Install and Enable BepInEx on a Valheim Server","Quick guide to installing and enabling the BepInEx framework on your Winheberg Valheim server via the Software Changer tool.","jeux","valheim","tabler:file-text","2026-08-11","Winheberg",79,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fvalheim\u002Finstall-bepinex-valheim.webp",[16,17,18,19],"Valheim","BepInEx","Tutorial","Server",[21,22,23,24,25],"install bepinex valheim","enable bepinex valheim","winheberg software changer","bepinexpack valheim","server bepinex setup","","\u002Fdocs\u002Fvalheim\u002Finstaller-bepinex-valheim","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>BepInEx\u003C\u002Fstrong> 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 \u003Cstrong>Software Changer\u003C\u002Fstrong> tool.\u003C\u002Fp>\n\u003Cp>This guide walks you through the step-by-step process of activating BepInEx on your server.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active Valheim server on your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Step 1: Stop the Server\u003C\u002Fh2>\n\u003Cp>To ensure a clean installation and prevent file conflict errors, your server must be completely shut down before changing software versions.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Log in to your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>On your server dashboard, click the red \u003Cstrong>Stop\u003C\u002Fstrong> button in the top right corner.\u003C\u002Fli>\n\u003Cli>Wait until the server status shows \u003Cstrong>Offline\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>Step 2: Enable BepInEx via Software Changer\u003C\u002Fh2>\n\u003Col>\n\u003Cli>In the left sidebar menu, scroll down to the \u003Cstrong>CONFIGURATION\u003C\u002Fstrong> section.\u003C\u002Fli>\n\u003Cli>Click on \u003Cstrong>Software Changer\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Locate the \u003Cstrong>Valheim BepInEx\u003C\u002Fstrong> entry in the software list.\u003C\u002Fli>\n\u003Cli>Choose your installation preference:\u003Cul>\n\u003Cli>Select \u003Cstrong>NOT DELETE FILES\u003C\u002Fstrong> to install BepInEx while preserving all your existing server data (world files, configurations).\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>Click the green \u003Cstrong>INSTALL\u003C\u002Fstrong> button.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>The panel will automatically download and deploy the BepInEx framework onto your server.\u003C\u002Fp>\n\u003Ch2>Step 3: Start the Server to Complete Setup\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Go back to the \u003Cstrong>Console\u003C\u002Fstrong> tab in the left menu.\u003C\u002Fli>\n\u003Cli>Click the green \u003Cstrong>Start\u003C\u002Fstrong> button.\u003C\u002Fli>\n\u003Cli>Observe the startup logs: BepInEx will automatically initialize as the server boots up.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Your Valheim server is now running on the BepInEx framework!\u003C\u002Fp>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ Installation gets stuck\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Server Status:\u003C\u002Fstrong> Ensure the server was completely turned off (\u003Cstrong>Offline\u003C\u002Fstrong>) before clicking \u003Cstrong>INSTALL\u003C\u002Fstrong>. If the server was running during installation, the process might fail.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Server fails to launch after switching to BepInEx\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Option Check:\u003C\u002Fstrong> If you accidentally selected a wipe option, check the \u003Cstrong>Files\u003C\u002Fstrong> tab to confirm system files are intact. You can re-run the installation via \u003Cstrong>Software Changer\u003C\u002Fstrong> at any time.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best Practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Always select "NOT DELETE FILES":\u003C\u002Fstrong> Unless you intend to perform a complete server wipe, keep this option selected to protect your world save.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Create a Backup:\u003C\u002Fstrong> Before switching software builds via Software Changer, create a precautionary backup from the \u003Cstrong>Backups\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need Assistance?\u003C\u002Fh2>\n\u003Cp>If you run into any issues while setting up BepInEx, our technical team is here to assist you. Submit a support ticket through \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\u002Flogin\">Winheberg Support\u003C\u002Fa>. 🎮\u003C\u002Fp>\n",1788993143483]