If the mods you want all list "Fabric" on Modrinth or CurseForge, you're in the right place. If even one essential mod is Forge-only, stop here and use Forge instead.

Step 1 — Download the Fabric Server Installer

Head to fabricmc.net/use/server and grab the latest installer (.jar file, usually under 1 MB). The installer itself is version-agnostic — it pulls the right Minecraft + Loader versions at install time based on your flags.

You'll also need:

• Java 21. Minecraft 1.20.5+ requires Java 21. Earlier versions want Java 17 or 8. If you're on a host, check which Java version is available. BruceNode nodes have Java 8 / 17 / 21 pre-installed and switchable from the panel.
• Your target Minecraft version. Pick the latest stable Fabric Loader supports — usually the current major MC release. As of 2026, that's Minecraft 1.21.x.

Step 2 — Run the installer in server mode

SSH or FTP into your server, drop the installer jar in an empty directory, then run:

java -jar fabric-installer-x.x.x.jar server -mcversion 1.21.4 -downloadMinecraft

Breakdown:

• server — tells the installer to build a server-ready file tree, not a client modpack.
• -mcversion 1.21.4 — replace with the Minecraft version you want. Omit this to use the current stable.
• -downloadMinecraft — fetches vanilla server.jar at the right version so you don't have to manually drop it in.

When it finishes, you'll see:

• fabric-server-launch.jar — the launcher that boots your Fabric server.
• server.jar — vanilla Minecraft, pulled automatically.
• libraries/ — Fabric's required libraries.

If you're on BruceNode, skip this step entirely — every Minecraft server has Fabric as a one-click preset. Panel → Software → Fabric. The installer runs automatically and the fabric-server-launch.jar shows up pre-configured.

Step 3 — Create the mods folder

mkdir mods

That's it. Drop your .jar mod files into this folder. Critical rule: every mod must target the same Minecraft version AND the same Fabric Loader version. Mismatches are the #1 reason servers fail to boot.

The Modrinth shortcut

Manually hunting down 40 compatible mods is painful. Two options save you the headache:

1. Modrinth server browser. Browse Modrinth, filter by "Fabric" + your MC version, download each jar. Tedious but works.
2. A host with the Modrinth installer baked into the panel. BruceNode ships with a Modrinth plugin in every Minecraft server's panel — browse mods, modpacks, and resource packs from inside the panel, click install, done. No SFTP, no version guessing.

Either way: keep a list of what you installed. When a mod breaks on an update, you need to know what's in the folder.

Fabric API — you almost always need it

Most Fabric mods depend on Fabric API, a separate jar from the mod loader itself. Download it from modrinth.com/mod/fabric-api, drop it in the mods/ folder next to everything else. Without Fabric API, about 80% of mods fail to load with a cryptic Missing dependency: fabric error.

Step 4 — Edit server.properties

First boot will fail because you haven't accepted the EULA. Open eula.txt:

eula=true

Then open server.properties and set the basics:

# Identity
server-name=My Fabric Server
motd=A Fabric server with \u00A7ecool mods
server-port=25565

# World
level-name=world
level-type=minecraft\:normal
difficulty=normal
hardcore=false
gamemode=survival

# Players
max-players=20
online-mode=true
white-list=false

# Performance
view-distance=10
simulation-distance=8
max-tick-time=60000

A few notes on values:

• view-distance + simulation-distance: a 20-player server at view-distance 10 needs ~4 GB of RAM minimum with a modest modpack. Heavier modpacks need more. Use our RAM calculator to size this properly.
• online-mode: true requires real Microsoft accounts. Set to false only if you're running a LAN or pirated-client server (not supported by us or any serious host).
• max-tick-time: lower this to 30000 (30 seconds) once your server is stable — catches runaway plugins faster.

Step 5 — Allocate RAM and start the server

The command to launch depends on how much RAM you're giving the server:

java -Xmx4G -Xms4G -jar fabric-server-launch.jar nogui

• -Xmx4G = max heap 4 GB.
• -Xms4G = starting heap 4 GB (same as max = less GC churn).
• nogui = headless; critical for server deployments.

For a production server, add the full Aikar flags — they're battle-tested for Minecraft's garbage collector:

java -Xmx4G -Xms4G \
  -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC -XX:+AlwaysPreTouch \
  -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 \
  -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 \
  -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 \
  -XX:InitiatingHeapOccupancyPercent=15 \
  -XX:G1MixedGCLiveThresholdPercent=90 \
  -XX:G1RSetUpdatingPauseTimePercent=5 \
  -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem \
  -XX:MaxTenuringThreshold=1 \
  -jar fabric-server-launch.jar nogui

BruceNode panels inject Aikar flags automatically when you pick the Fabric preset. No memorizing required.

Five boot errors and how to fix each one

1. Caused by: net.fabricmc.loader.api.metadata.ModDependency

What it means. A mod depends on another mod you didn't install. The error log usually names the missing mod.

Fix. Install the dependency (usually Fabric API) + anything it names. Keep the versions aligned.

2. Mismatched Fabric Loader version

What it means. You installed a mod built for Fabric Loader 0.15 on Loader 0.14 (or vice versa).

Fix. Re-run the Fabric installer with -loader <version> to match what your mods expect, or upgrade/downgrade the offending mod.

3. EULA not accepted

What it means. eula.txt still has eula=false.

Fix. Set it to true. This is Mojang's license agreement for running a server; you do need to accept it.

4. Port 25565 already in use

What it means. Another Minecraft server or service has the port.

Fix. Change server-port in server.properties to an open port (e.g. 25566). Update your DNS SRV record if you use one so play.yourdomain.com still resolves correctly. BruceNode subdomains auto-handle SRV records for you.

5. Can't keep up! Running Xms behind

What it means. Your server can't run fast enough — either too few CPU cycles, too little RAM, or too much in a single chunk. Not technically a boot error, but you'll see it in logs after a few minutes.

Fix. Allocate more RAM (-Xmx), raise your plan tier, or reduce view-distance. Modern modpacks on slow hardware are the usual culprit. If you're on shared hosting with throttled CPU, move to dedicated-core hosting — on BruceNode every Minecraft server runs on premium high-clock AMD hardware, so you get real single-thread performance per TPS.

Post-install — the three things every Fabric server should do

1. Daily backups. Set up a /backup rotation at midnight server time. BruceNode backups are a one-toggle add-on; manual setups use crontab + mcrcon save-all.
2. Performance mods. Install Lithium, Starlight, and FerriteCore. These three alone can double your TPS on a busy modded server with zero gameplay changes.
3. Monitor RAM usage. A Fabric server that's constantly at 95%+ heap will stutter. Bump RAM or trim mods before players start complaining.

Frequently asked questions

Can I install Fabric on an existing vanilla server without losing my world?

Yes. Back up the world/ folder, run the Fabric installer in the same directory, drop mods in, and restart. Worlds are vanilla-compatible until you add mods that alter worldgen (like Biomes O' Plenty).

Does Fabric work with plugins like EssentialsX or LuckPerms?

Not directly — plugins are a Bukkit/Spigot/Paper thing. There's a Fabric mod called Cardboard that ports Bukkit API to Fabric servers, but compatibility varies. For most plugin-heavy setups, use Paper instead of Fabric.

How much RAM does a 20-player Fabric server need?

About 4-6 GB for a lightly modded server (Sodium/Lithium/Fabric API). 8-12 GB for a medium modpack. 16+ GB for a kitchen-sink modpack like Create: Fabric. Calculate it properly with our RAM calculator.

What's the best Fabric hosting for 2026?

The right host gives you: fast single-thread CPU (3.8 GHz+), NVMe disk, Java 21 support, and ideally a panel with the Modrinth installer. BruceNode's Minecraft plans start at $2/mo, run on premium AMD hardware, and have Fabric as a one-click preset. Use BRUCE20 for 20% off your first month.

Closing — installing Fabric is a 10-minute job done right

Modded Minecraft has earned its "install hell" reputation, but Fabric cuts the worst of it. If you get the version alignment correct and install Fabric API, most problems disappear. If you're on a panel like BruceNode's, the whole thing compresses into a single-click preset.

If you run into an install error we didn't cover here, open a ticket in our Discord or email hi@brucenode.com — we've debugged enough Fabric boots to spot most issues from the log's first five lines.

Happy modding.