Skip to main content

Installing Mods on a Server

This guide explains how to install mods on a Minecraft server, using Fabric version 1.21.1 as an example here, with mods sourced from Modrinth.

Prerequisites​

  • The server is already using software that supports mods (Fabric/Forge/etc)
  • Access to the server files through the hosting panel or SFTP
  • Mods compatible with Forge/Fabric and the server version

Mod Installation Steps​

NOTE: The Example Here Will Use Fabric v1.21.1

1. Find a Compatible Mod​

Visit the Modrinth site to find a suitable mod.

  1. Use the filters under Game Options:

    • Check the version: 1.21.1(Adjust to the server version you're using)
      panel
    • Loader: Fabric(Adjust to the server software (egg) you're using)
      panel
    • Environment: Server
      panel

  2. Choose the mod you want to use. Example: Fabric API

2. Download the Mod​

  1. Click the page of the mod you selected (example: Fabric API)
  2. Click the Download button
  3. Select the game version: 1.21.1(Adjust to the server version you're using)
  4. Click Download to download the .jar file

3. Import the Mod to the Server​

  1. Access the server files through the panel or SFTP
  2. Open the folder:
/home/container/mods
  1. Upload the mod's .jar file into that folder

4. Restart the Server​

Once the mod has been uploaded successfully:

  • Go back to the main panel
  • Click the Restart button
  • The server will load the mod on startup

Verification​

  • Check the server log to make sure the mod loaded successfully
  • Some mods may require additional dependencies (make sure all required files have been uploaded)

Additional Tips​

  • Always use a mod version that matches your Fabric and Minecraft version
  • Avoid mixing mods from different loaders (for example Fabric and Forge)
  • Back up your server before adding new mods to avoid conflicts