services:
  minecraft:
    image: git.jeremymcclure.com/jeremy/dockercraft:latest
    container_name: minecraft
    stdin_open: true
    tty: true
    environment:
      - EULA=true
      - MC_VERSION=1.21.1
      - MC_LOADER=neoforge
      - MC_LOADER_VERSION=21.1.185
      - JAVA_VERSION=temurin@21
      - XMS=2G
      - XMX=4G
      - PUID=1000
      - PGID=1000
    volumes:
      - ./data:/data
    ports:
      - 25565:25565
    restart: unless-stopped

Environment Variables

Variable	Default	Description
`EULA`	—	Required. Set to `true` to accept the Minecraft EULA
`MC_VERSION`	—	Minecraft version (e.g., `1.21.1`)
`MC_LOADER`	—	Server loader: `vanilla`, `paper`, `fabric`, `forge`, or `neoforge`
`MC_LOADER_VERSION`	—	Fallback version for any loader
`FABRIC_LOADER_VERSION`	`$MC_LOADER_VERSION`	Fabric loader version
`FORGE_VERSION`	`$MC_LOADER_VERSION`	Forge version (e.g., `52.1.14`)
`NEOFORGE_VERSION`	`$MC_LOADER_VERSION`	NeoForge version (e.g., `21.1.185`)
`PAPER_BUILD`	latest	Paper build number (auto-detects latest if unset)
`JAVA_VERSION`	auto-detected	Java version (via Jabba, e.g., `temurin@21`, `zulu@17`). Auto-detects from Mojang manifest if unset: 1.20.5+→21, 1.17-1.20.4→17, 1.17→16, pre-1.17→8
`JAR`	`server.jar`	Server jar filename
`XMS`	`2G`	Initial Java heap size
`XMX`	`4G`	Maximum Java heap size
`ADD_ARGS`	—	Additional Java arguments
`PUID`	`1000`	User ID for /data ownership
`PGID`	`1000`	Group ID for /data ownership

Supported Loaders

Vanilla — Official Mojang server
Paper — High-performance papermc.io
Fabric — Lightweight mod loader via fabricmc.net
Forge — Heavyweight mod loader via minecraftforge.net
NeoForge — Fork of Forge via neoforged.net
Bedrock — Official Bedrock dedicated server (native binary, no Java required)

Volumes

/data — Persists server data, worlds, config, and Java installations