--- title: "Install mods on your Project Zomboid server" description: "Install Steam Workshop mods on a Project Zomboid server hosted on the OVHcloud Game Panel, add several Workshop IDs at once, and manage individual Mod IDs." url: https://docs.ovhcloud.com/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-install-mods-project-zomboid lang: en lastUpdated: 2026-07-31 --- # Install mods on your Project Zomboid server ## Objective The OVHcloud Game Panel lets you customise your Project Zomboid server by installing mods from the Steam Workshop. **This guide explains how to install mods on your Project Zomboid server hosted on the OVHcloud Game Panel.** ## Requirements - A [VPS](https://www.ovhcloud.com/en-gb/vps/) or a [dedicated server](https://www.ovhcloud.com/en-gb/bare-metal/) in your OVHcloud account with the Game Panel feature enabled. - A Project Zomboid server deployed on the Game Panel. Refer to [Deploy a Project Zomboid server on the Game Panel](/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-quick-start-project-zomboid/index.md). - Access to the Game Panel. Refer to [Log in to the Game Panel](/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-log-in/index.md). ## Instructions ### Step 1 — Find the mods you want Project Zomboid mods are distributed through the [Steam Workshop](https://steamcommunity.com/app/108600/workshop/). Browse the Workshop and find the mods you want to install. Once you have opened a mod's page, look at the URL in your browser. The **Workshop ID** is the number that appears after `?id=`. For example: ```text https://steamcommunity.com/sharedfiles/filedetails/?id=3762296152 ``` In this example, the Workshop ID is `3762296152`. Copy this ID: you need it in the next step. ![The Workshop ID highlighted in the browser address bar on a Project Zomboid mod page](/images/bare-metal-cloud/virtual-private-servers/game-panel-install-mods-project-zomboid/steam-workshop-mod-page.png) :::warning Always make sure the mod is compatible with your server's game version. For example, a Build 41 (B41) mod will most likely not work on a Build 42 (B42) server. Installing incompatible mods may prevent your server from starting. ::: ### Step 2 — Add the mod through the Game Panel :::warning Your server must be stopped before you add or remove mods. Mod changes apply on the next start. ::: If your server is running, stop it first: in the `Game Servers` list, click the stop icon in the **Power** column of your server, then confirm. All connected players are disconnected. In the Game Panel, find your Project Zomboid server in the `Game Servers` list, then go to `Settings ` > `Game Config ` > `Mods `. ![The Mods tab under Game Config in the Game Panel](/images/bare-metal-cloud/virtual-private-servers/game-panel-install-mods-project-zomboid/game-config-mods-tab.png) Click `Add mods `, then enter the Workshop ID you copied earlier. ![Entering a Workshop ID in the Add Workshop mods dialog](/images/bare-metal-cloud/virtual-private-servers/game-panel-install-mods-project-zomboid/add-mods.png) #### Adding several mods at once You can add several Workshop IDs at once by separating them with: - spaces - commas - new lines After adding your mods, you can rearrange their **loading order** with the up and down arrows on each row. #### Mods with several Mod IDs Some Workshop items contain several **Mod IDs**. For example, a user interface overhaul may include two Mod IDs: - `UI_Dark` - `UI_Light` In this case, enable only one of them, not both. You can enable or disable individual Mod IDs using the toggle switch at the end of each row. ![Installed mods list showing the loading order and the per-row toggle switch](/images/bare-metal-cloud/virtual-private-servers/game-panel-install-mods-project-zomboid/mods-list.png) ### Step 3 — Start your server Return to the main page of the Game Panel and click `Start ` to launch your server. When players connect, the Project Zomboid client automatically downloads any Workshop mods installed on the server. ### Increase the game's RAM allocation If you are running many mods, Project Zomboid may require more memory on the client side. If the game struggles to launch or crashes because of heavy mod usage, allocate more RAM. To do so: 1. Close Project Zomboid completely. 2. Open **Steam** and locate **Project Zomboid** in your library. 3. Click the gear icon on the right. 4. Select **Manage** > **Browse local files**. 5. In the game folder, locate the `ProjectZomboid64.json` file and open it with **Notepad** (or any text editor). 6. Scroll down until you find the `VMArgs` section. 7. Locate the line containing `-Xmx3072m` and replace the memory value with a larger one, for example `-Xmx8g`. This allocates 8 GB of RAM to the game, if your computer has enough memory. 8. Save the file, close it, and launch Project Zomboid again. :::info Do not allocate all your system's RAM to the game. Leave enough memory available for the operating system and any background applications, so that your system remains stable. ::: ### Install mods manually You can also install mods manually instead of using the automatic Workshop importer. The file to edit manually is `/zomboid/Server/.ini` (by default `servertest.ini`). The Game Panel links to it directly: open `Settings ` > `Game Config ` > `Server Settings `, expand `Advanced Configuration `, then click `Open in File Manager ` next to the **INI** entry. :::warning Do not use both methods at the same time. If you install your mods manually and later use the automatic mod import feature, your manual changes may be overwritten, which can lead to conflicts or configuration loss. Choose either automatic installation or manual installation, but avoid mixing the two. ::: ## Go further - [Deploy a Project Zomboid server on the Game Panel](/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-quick-start-project-zomboid/index.md) - [Getting started with the Game Panel](/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-getting-started/index.md) - [How to use the Game Panel File Manager](/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-file-manager/index.md) - [How to create and restore backups on the Game Panel](/en/guides/bare-metal-cloud/virtual-private-servers/game-panel-backups/index.md) Join our [community of users](https://community.ovhcloud.com/).