Skip to main content

Setup a Modded Minecraft Server on TrueNAS Scale with CurseForge

Setup a TrueNAS SMB Share (if you don’t have one)​

If no SMB share is setup and connected to your PC via file explorer, watch this video from 00:00 to 06:21:

⚠️

Now open File Explorer (⌘ + E on Windows) and create a folder called “Minecraft” on your SMB share.

Installing Modded Minecraft With CurseForge Overview​

CurseForge is a popular Minecraft mod platform. We will use the pack "All the Mods 10".

  1. Download CurseForge app here
  2. Browse mods here
  3. Use the modpack here

Pick Your Mod Pack​

Select the pack's files tab to find server-side files (needed for TrueNAS).

All the Mods 10 Pack Overview Pack files tab Server side files

Setup Minecraft Server on TrueNAS​

Log into your TrueNAS machine:

TrueNAS Login

Go to Apps > Discover Apps, search "Minecraft", choose Minecraft Server (Java) and install.

Minecraft server install

Configure Modded Minecraft Server​

Fill in these important fields:

  1. Application Name
  2. Timezone
  3. Accept EULA
  4. Image Selector (choose Java version per modpack requirements)
  5. Type (mod loader, e.g., NeoForge)
  6. Version (Minecraft version required by modpack)
Server config steps 1-6
  1. RCON Password
RCON password
  1. Add environment variables:
    CF_PAGE_URL (modpack page URL),
    CF_API_KEY (from your CurseForge profile's API keys: https://console.curseforge.com/?#/api-keys)
  2. Add memory settings INIT_MEMORY and MAX_MEMORY, e.g., 16G.
Env variables
  1. Set Host IPs and adjust ports as necessary.
Host IP and ports

  1. Under Storage Configuration select Host Path, enable ACL, and set directory to your SMB share Minecraft folder.

  2. Enable ACL Force Flag.

Storage config
  1. Set CPU cores (e.g., 4)
  2. Set Memory (12-16GB, consistent with environment variables)
  3. Save/Update.
CPU and memory

Stop the server if deploying:

Stop server

Empty your Minecraft folder on SMB share.

Empty folder

Extract downloaded CurseForge server files, copy highlighted files into the SMB Minecraft folder.

Extract files Copy server files

Start your Minecraft server on TrueNAS:

Start server

Watch logs for errors and troubleshooting:

View logs

Adding the Modpack to CurseForge Client​

In the CurseForge app, select Minecraft, search and install your modpack.

CurseForge app

After install, find it under My Modpacks.

My Modpacks

Click Play and login if required.

Play modpack

The launcher shows your modded Minecraft version, click Play.

Play launcher

Connect to your server on multiplayer tab with IP and port:

Connect multiplayer

Enjoy your Modded Minecraft Server!

Modded Minecraft gameplay

Follow Us on Social Media​

YouTube
Discord
Patreon
Reddit
Rumble