Skip to main content
Feed the Beast Application modpacks are supported by setting MODPACK_PLATFORM, MOD_PLATFORM or TYPE to FTBA.
The “A” at the end of “FTBA” is important. The value “FTB” used to be an alias for “CURSEFORGE”.
This mod platform type automatically handles downloading and installing the modpack and appropriate version of Forge, so the VERSION does not need to be specified.
Requires one of the Ubuntu with Hotspot images. See the Java versions documentation for available images.

Environment Variables

VariableRequiredDescription
TYPEYesSet to FTBA
FTB_MODPACK_IDYesNumerical ID of the modpack to install
FTB_MODPACK_VERSION_IDNoNumerical ID of specific version (defaults to latest)
FTB_FORCE_REINSTALLNoForce re-installation if files are inconsistent

Finding the Modpack ID

The modpack ID can be located by:
1

Find your modpack

Browse to FTB Modpacks and locate your desired modpack
2

Extract the ID from the URL

The ID is the number in the URL:
https://www.feed-the-beast.com/modpacks/23-ftb-infinity-evolved-17
                                        ^^
In this example, the modpack ID is 23

Finding the Version ID

The version ID is optional. To find it:
1

Navigate to the modpack page

Go to your modpack’s page on feed-the-beast.com
2

Hover over a server file

Hover over a server file entry to see the download link
3

Extract the version ID

The version ID appears in the popup URL

Basic Usage

services:
  mc:
    image: itzg/minecraft-server:java8-multiarch
    environment:
      EULA: "TRUE"
      TYPE: FTBA
      FTB_MODPACK_ID: 31
    ports:
      - "25565:25565"
    volumes:
      - ./data:/data

Example: FTB Presents Direwolf20 1.12

This example runs the latest version of FTB Presents Direwolf20 1.12:
docker run -d --pull=always -v /path/on/host:/data \
    -e EULA=TRUE -e TYPE=FTBA \
    -e FTB_MODPACK_ID=31 -p 25565:25565 \
    itzg/minecraft-server:java8-multiarch
services:
  mc:
    image: itzg/minecraft-server:java8-multiarch
    environment:
      EULA: "TRUE"
      TYPE: FTBA
      FTB_MODPACK_ID: 31
      MEMORY: 4G
    ports:
      - "25565:25565"
    volumes:
      - mc-data:/data

volumes:
  mc-data:

Upgrading

Automatic Upgrades

If a specific FTB_MODPACK_VERSION_ID was not specified, simply restart the container to pick up the newest modpack version:
docker compose restart mc

Manual Version Upgrades

If using a specific version ID, recreate the container with the new version ID:
1

Update version ID

Edit your compose file and update FTB_MODPACK_VERSION_ID
2

Recreate container

docker compose up -d

Troubleshooting

Force Reinstall

If files become inconsistent (e.g., accidentally removing files), force FTB to re-run:
environment:
  FTB_FORCE_REINSTALL: "true"
Remember to set this back to false or remove it after the reinstall completes to avoid reinstalling on every restart.

Java Version Compatibility

FTB modpacks typically require specific Java versions:
  • Java 8: Most legacy FTB packs (1.7.10 - 1.12.2)
  • Java 17+: Modern FTB packs (1.18+)
Use the appropriate image tag:
image: itzg/minecraft-server:java8-multiarch
# or
image: itzg/minecraft-server:java17
Most FTB modpacks require at least 4GB of memory. Set MEMORY to 4G or higher.

Build docs developers (and LLMs) love