How to add a mod to your Minecraft server (Portallis panel)

Step-by-step guide

by the end, your Minecraft server loads the mod, with no manual file upload.

Time : 5 minutesLevel : beginnerChecked : 17 Nov 2026 (Minecraft 1.21.11)

Before you start

  • A Portallis Minecraft server (it starts as Vanilla by default). Vanilla cannot run mods: you need a loader such as Fabric or Forge. This guide uses Fabric.
  • Know your players’ Minecraft version (for example 1.21.11). Server and players must match.
  • Optional but wise: make a backup (the “Sauvegarde” tab) if your world matters.
  • Some mods must also be installed on your players’ computers. The mod in this guide (Lithium) is server-side only: your players install nothing.
1

Open your server in the panel

Go to panel.portallis.com and log in. The “Serveurs” page lists your servers with their state (En ligne / Hors ligne), IP address, memory and disk use. Click Gérer le serveur under your Minecraft server.

How to add a mod to your Minecraft server (Portallis panel) : Server list, Gérer le serveur button
Server list, Gérer le serveur button
2

Find the “Minecraft” section of the menu

In the left menu, scroll down to the MINECRAFT section. It holds the game’s own tools: Extensions (plugins), Versions (server type), Mods, Modpacks, Worlds and Propriétés. We will use Versions, then Mods.

Left menu, Minecraft section
Left menu, Minecraft section
3

Install Fabric (the loader that allows mods)

Click Versions. The screen lists server types: Vanilla, Paper, Spigot, Forge, Fabric, NeoForge and more. For mods, pick Fabric (or Forge/NeoForge, depending on your mods) and click Browse next to Fabric.

Versions page, Fabric Browse button
Versions page, Fabric Browse button

A window opens:

  1. Select a version: choose your players’ Minecraft version (here 1.21.11). Pick a normal release, not a line containing “snapshot” or “rc”: those are test builds.
  2. Zone dangereuse (Danger zone): leave the box unticked. Ticked, it resets the server and deletes all your files (world, configuration, extensions).
  3. Click Installer (Install).
Fabric install window
Fabric install window

When it is done, the panel shows “Fabric 1.21.11 a été installé avec succès” (installed successfully) and the Versions page shows Fabric marked Current: that is your server type now.

Fabric installed
Fabric installed
4

Search for the mod

Click Mods in the menu. The Browse mods tab shows popular mods from the Modrinth and CurseForge catalogues. Type the mod’s name in the search bar (here “Lithium”). The Filters button sorts by platform, game version and loader.

Mods page, search and filters
Mods page, search and filters
Lithium search result
Lithium search result

Set the filters to avoid mistakes. In Filters, pick your server’s version (1.21, then 1.21.11) and the Fabric loader.

Filters panel
Filters panel
1.21.11 and Fabric selected
1.21.11 and Fabric selected
5

Pick the right version of the mod (the step that matters)

Click Select version under the mod. In the window, the “Select a version” list offers every version of the mod, for every loader and every Minecraft version. Careful: the line shown by default is not necessarily the right one. Here it says “neoforge … mc26.3”, while our server runs Fabric 1.21.11.

Default version offered: the wrong one
Default version offered: the wrong one

Open the list and choose the line that contains both your loader name (“fabric”) and your Minecraft version (“mc1.21.11”), for example “lithium fabric 0.21.4+mc1.21.11”. Then click Install mod.

Right version chosen and Install mod button
Right version chosen and Install mod button

The panel confirms “Mod installed successfully” and the mod’s card shows Mod Installed.

Mod installed
Mod installed
6

Check the list of installed mods

Open the Installed mods tab (the number is how many mods you have). Each mod is listed with its exact version name. The red bin removes it if needed.

Installed mods
Installed mods
7

Start (or restart) the server

Click the green start button at the top of the left menu (or Restart if the server was already running). On the very first start, Minecraft asks you to accept its licence agreement (EULA). Read it, then click I ACCEPT: the server then restarts by itself.

EULA window
EULA window
8

Check in the console

Open Console. During startup the console lists the loaded mods: you should see lithium 0.21.4+mc1.21.11 (or your mod) and the Minecraft version.

Console: the mod is loaded
Console: the mod is loaded

A few seconds later the line Done (…s)! For help, type “help” appears, then the panel says “Server marked as running”: your server is ready with your mod.

Console: server ready
Console: server ready

If it does not work

The server crashes or stops at startup and the console mentions a “mod”

the mod version does not match your loader or Minecraft version. Go to Mods > Installed mods, delete the mod (bin icon), then redo step 5 choosing the line with the right loader and version.

The console asks for a dependency

(for example “Fabric API”): many Fabric mods need it. Install it like any mod (steps 4 and 5), then restart.

“You need to agree to the EULA”

shows on first start: that is normal, accept the EULA (step 7).

The server is slow or stops with many mods

check memory on the dashboard. The more mods, the more RAM you need. You can add RAM at any time.

Your players cannot join

many mods must also be installed on their side, in the same version. Lithium does not need to be.

Questions? Get in touch

Our team will answer by message or on Discord.

No Minecraft server yet?

Launch yours in minutes. €1 = 1 GB.

See the Minecraft plans