Skip to content

How to Install Mods on Your Minecraft Java Server

You can install mods on your server to add new content, mechanics or improvements.

Note

Mods only work with mod-capable server versions such as Forge, NeoForge, Fabric or Quilt. Vanilla, Spigot or Paper servers do not support mods. If you want to use plugins instead, see: Install Plugins.

Where can I find mods?

You can find mods on the following platforms:

Important

Only download mods from trusted sources. Mods from unknown sources may contain malicious code. Make sure the mod is compatible with your Minecraft version and mod loader (Forge, Fabric, etc.).

Add mods

  1. Download the mod
    Download the desired mod as a .jar file. Make sure it matches your mod loader and Minecraft version.

  2. Stop the server
    Stop your server via the dashboard.

  3. Connect via SFTP
    Connect to your server via SFTP.

  4. Upload the mod
    Upload the .jar file to the /mods/ folder.

  5. Start the server
    Start your server.

Tip

After the first start, most mods create their own folder under /config/ with configuration files that you can customize.

Remove a mod

  1. Stop the server
    Stop your server via the dashboard.

  2. Delete the mod
    Delete the mod's .jar file from the /mods/ folder.

  3. Start the server
    Start your server.

Note

Most mods must be installed on both the server and every player's client. Check the mod description to see if a client-side installation is required.