Skip to main content
This mod platform type is deprecated. Please use Auto CurseForge for new deployments.

​
Overview

Enable this server mode by setting MODPACK_PLATFORM, MOD_PLATFORM or TYPE to CURSEFORGE. You need to specify a modpack to run using the CF_SERVER_MOD environment variable. CurseForge server modpacks are available together with their respective client modpacks at CurseForge Modpacks.

​
Environment Variables

VariableRequiredDescription
TYPEYesSet to CURSEFORGE
CF_SERVER_MODYesFilename or path to the server modpack ZIP file
CF_BASE_DIRNoDirectory where modpack is expanded (default: /data/FeedTheBeast)
USE_MODPACK_START_SCRIPTNoUse bundled start script (default: true)
FTB_LEGACYJAVAFIXERNoApply legacy Java fixer workaround (default: false)

​
Basic Usage

1

Download the server modpack

Download the server modpack ZIP file from CurseForge
2

Configure with filename

Reference the modpack file by name:
docker run -d --pull=always -v /path/on/host:/data \
    -e TYPE=CURSEFORGE \
    -e CF_SERVER_MOD=SkyFactory_4_Server_4.1.0.zip \
    -p 25565:25565 -e EULA=TRUE --name mc \
    itzg/minecraft-server

​
Using a Separate Modpack Directory

To keep pre-downloaded modpacks separate from your data directory, attach another volume: 
docker run -d --pull=always -v /path/on/host:/data \
    -v /path/to/modpacks:/modpacks \
    -e TYPE=CURSEFORGE \
    -e CF_SERVER_MOD=/modpacks/SkyFactory_4_Server_4.1.0.zip \
    -p 25565:25565 -e EULA=TRUE --name mc \
    itzg/minecraft-server

services:
  mc:
    image: itzg/minecraft-server
    environment:
      EULA: "TRUE"
      TYPE: CURSEFORGE
      CF_SERVER_MOD: /modpacks/SkyFactory_4_Server_4.1.0.zip
    volumes:
      - ./data:/data
      - ./modpacks:/modpacks
    ports:
      - "25565:25565"

​
Modpack Data Directory

By default, CurseForge modpacks are expanded into /data/FeedTheBeast and executed from there. This location was chosen for legacy reasons when Curse and FTB were maintained together. Change the directory by setting CF_BASE_DIR: 
environment:
  CF_BASE_DIR: /data

​
Advanced Configuration

​
Buggy Start Scripts

Some modpacks have buggy or overly complex start scripts. Avoid using the bundled start script by setting: 
environment:
  USE_MODPACK_START_SCRIPT: "false"

​
Fixing “unable to launch forgemodloader”

If your server fails to load with an error like: 
unable to launch forgemodloader
Apply this workaround: 
environment:
  FTB_LEGACYJAVAFIXER: "true"

​
Migration to Auto CurseForge

For better automation, upgrade tracking, and cleanup capabilities, migrate to Auto CurseForge.
Auto CurseForge provides:
  • Automatic version upgrades
  • File cleanup between versions
  • API-based modpack installation
  • Better mod exclusion/inclusion controls
See the Auto CurseForge documentation for migration instructions.

Build docs developers (and LLMs) love

Get started for freeTalk to us