# How to Install Mods on Your DayZ Server (/docs/dayz/mod-setup)









import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { File, Folder, Files } from 'fumadocs-ui/components/files';

XGamingServer includes a **built-in DayZ Mod Manager** that handles everything automatically — no manual file uploads, no bikey copying, no folder renaming.

<Tabs items={['Via Panel Mod Manager (Recommended)', 'Manual Install']}>
  <Tab value="Via Panel Mod Manager (Recommended)">
    The Mod Manager browses the Steam Workshop and handles installation automatically — including lowercasing folders and copying bikey files.

    <Steps>
      <Step>
        Open the Mod Manager [#open-the-mod-manager]

        In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Mods** in the sidebar (visible on DayZ servers).
      </Step>

      <Step>
        Browse and install mods [#browse-and-install-mods]

        On the **Steam Workshop** tab, search for mods by name. Click **Install** on any mod.

                <img alt="DayZ Workshop mod browser" src={__img0} placeholder="blur" />

        The mod is added to the `MODIFICATIONS` startup variable automatically. Installed mods show a green **Installed** checkmark.
      </Step>

      <Step>
        Restart the server [#restart-the-server]

        Go to **Console** and restart. On startup, the server automatically:

        * Downloads the mod via SteamCMD
        * Lowercases all folder and file names
        * Copies `.bikey` files to the `keys/` folder
      </Step>
    </Steps>

    Manage Installed Mods [#manage-installed-mods]

    Switch to the **Installed Mods** tab to see all your mods:

        <img alt="Installed mod with Client badge" src={__img1} placeholder="blur" />

    Each mod shows:

    * **Workshop ID** and external link
    * **Client** (green) or **Server-side** (yellow) badge
    * **To Server** / **To Client** toggle button
    * **Uninstall** button

    Client vs Server-Side Mods [#client-vs-server-side-mods]

    | Type                           | Startup variable             | Players need it?           | Examples                                 |
    | ------------------------------ | ---------------------------- | -------------------------- | ---------------------------------------- |
    | **Client** (green badge)       | `MODIFICATIONS` (`-mod=`)    | Yes — players must install | Maps, weapons, vehicles, UI mods         |
    | **Server-side** (yellow badge) | `SERVERMODS` (`-serverMod=`) | No — runs on server only   | Admin tools, logging, server-side tweaks |

    Click **To Server** to move a mod to server-side only:

        <img alt="Installed mod with Server-side badge" src={__img2} placeholder="blur" />

    Click **To Client** to move it back. The mod files stay on disk — only the startup command changes. Takes effect on next restart.
  </Tab>

  <Tab value="Manual Install">
    If you prefer manual control, you can still upload mods yourself.

    <Steps>
      <Step>
        Download the mod [#download-the-mod]

        Subscribe on the [Steam Workshop for DayZ](https://steamcommunity.com/app/221100/workshop/). The mod downloads to `steamapps/workshop/content/221100/<WorkshopID>/` on your PC.
      </Step>

      <Step>
        Upload to the server [#upload-to-the-server]

        Stop the server. Click **Files** and upload the mod folder to the server root with an `@` prefix:

        <Files>
          <Folder name="(server root)" defaultOpen>
            <Folder name="@cf" defaultOpen>
              <Folder name="addons">
                <File name="cf.pbo" />
              </Folder>

              <Folder name="keys">
                <File name="cf.bikey" />
              </Folder>
            </Folder>

            <Folder name="keys" defaultOpen>
              <File name="cf.bikey" />
            </Folder>
          </Folder>
        </Files>
      </Step>

      <Step>
        Copy bikey files [#copy-bikey-files]

        Copy every mod's `.bikey` file from its `keys/` subfolder into the server's root `keys/` folder.

        > Missing bikeys = players get kicked with "signature verification failed."
      </Step>

      <Step>
        Add mods in Startup [#add-mods-in-startup]

        In **Startup**, find **Additional Mods**. Enter folder names — **all lowercase**, semicolon-separated:

        ```
        @cf;@vppadmintools;@trader;
        ```

        > **Do NOT include `-mod=`** — the panel adds it automatically.

        > **Lowercase only.** Enable **\[Repair] Make Mod Files Lowercase** in Startup for one restart if you uploaded from Windows.
      </Step>

      <Step>
        Restart [#restart]

        Start from **Console**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Common Dependencies [#common-dependencies]

| Mod                      |  Workshop ID | Must load before       |
| ------------------------ | :----------: | ---------------------- |
| CF (Community Framework) | `1559212036` | Most community mods    |
| DayZ-Expansion-Core      |    varies    | DayZ Expansion modules |

Related Guides [#related-guides]

* [Server Configuration](/docs/dayz/server-config)
* [How to Change the Map](/docs/dayz/map-guide)
* [Admin & RCON Setup](/docs/dayz/admin-setup)
* [Make Server Public](/docs/dayz/make-server-public)