English | 简体中文
This image is not using automatic test yet, always backup your world
If you're using Docker Desktop on Windows 11, disable 'Use the WSL 2 based engine' in Docker Desktop settings to use Hyper-V as backend, or your world might be corrupted. This issue
Only support MCDReforged 2.x
Docker image for MCDReforged.
Based on itzg/docker-minecraft-server.
$ docker pull notevenaneko/mcdr-docker:latest
$ docker run -it -e EULA=TRUE notevenaneko/mcdr-docker:latest
MUST use with -i
and -t
because MCDReforged will read EOF and exit if stdin is closed, or modify config.yml in the next section.
version: "3.8"
services:
mcdr:
image: notevenaneko/mcdr-docker:latest
environment:
- EULA=TRUE
ports:
- 25565:25565
stdin_open: true
tty: true
stdin_open
and tty
MUST be true
, or set disable_console_thread
to true
in config.yml of MCDReforged.
See https://github.com/itzg/docker-minecraft-server.
You can attach your volume to /data
and /mcdr
.
/data
is the Minecraft main directory provided by itzg/docker-minecraft-server, see https://github.com/itzg/docker-minecraft-server#data-directory.
/mcdr
is the directory of MCDReforged, see https://mcdreforged.readthedocs.io/zh_CN/latest/quick_start.html#start-up.
version: "3.8"
services:
mcdr:
image: notevenaneko/mcdr-docker:latest
environment:
- EULA=TRUE
ports:
- 25565:25565
volumes:
- /path/to/your/server.property:/data/server.property
- /path/to/your/world:/data/world
- /path/to/your/mcdr/config.yml:/mcdr/config.yml
- /path/to/your/mcdr/plugins:/mcdr/plugins
stdin_open: true
tty: true
or simply mount two directory
version: "3.8"
services:
mcdr:
image: notevenaneko/mcdr-docker:latest
environment:
- EULA=TRUE
ports:
- 25565:25565
volumes:
- /path/to/your/mc:/data
- /path/to/your/mcdr:/mcdr
stdin_open: true
tty: true
Set environment variable BOOT_FROM_SOURCE
to non-empty string.
version: "3.8"
services:
mcdr:
image: notevenaneko/mcdr-docker:latest
environment:
- EULA=TRUE
- BOOT_FROM_SOURCE=TRUE
ports:
- 25565:25565
stdin_open: true
tty: true
Set environment variable MCDR_VERSION
to valid version number, 2.0 or above is supported.
version: "3.8"
services:
mcdr:
image: notevenaneko/mcdr-docker
environment:
- EULA=TRUE
- MCDR_VERSION=2.3.2 # Use MCDReforged v2.3.2
ports:
- 25565:25565
stdin_open: true
tty: true
Change environment variable UID
and GID
to change user, or use --user 1000:1000
to boot with user 'minecraft'
version: "3.8"
services:
mcdr:
image: notevenaneko/mcdr-docker:latest
environment:
- EULA=TRUE
- PID=0 # run main server using root
- GID=0
ports:
- 25565:25565
stdin_open: true
tty: true
FABRIC
orVANILLA
:vanilla_handler
FORGE
:forge_handler
BUKKIT
orSPIGOT
:bukkit14_handler
when game version is 1.14 and above,bukkit_handler
otherwisePAPER
orMOHIST
:bukkit_handler
CATSERVER
:cat_server_handler
- other:
vanilla_handler
- No automatic test, manual test is required before release
- Some environment variable in itzg/docker-minecraft-server may not have the same effect.
- Some implementations is not graceful enough.