docker-minecraft-server/minecraft-server/README.md
Geoff Bourne 7d8429ef0a Allowing for pre-existing eula.txt
Adding memory settings info to README
2014-09-08 02:32:55 +00:00

2.9 KiB

This docker image provides a Minecraft Server that will automatically download the latest stable, latest snapshot, or any specific server version.

To simply use the latest stable version, run

docker run -d -p 25565:25565 itzg/minecraft-server

where the default server port, 25565, will be exposed on your host machine.

Mojang now requires accepting the Minecraft EULA. To accept add

-e EULA=TRUE

such as

docker run -e EULA=TRUE -d -p 25565:25565 itzg/minecraft-server                                                                                                                                                                      

In order to persist the Minecraft data, which you probably want to do for a real server setup, use the -v argument to map a local path to the `/data' path in the container,

docker run -d -v /path/on/host:/data -p 25565:25565 itzg/minecraft-server                               

To use a different Minecraft version, pass the VERSION environment variable, which can have the value

  • LATEST
  • SNAPSHOT
  • (or a specific version, such as "1.7.9")

For example, to use the latest snapshot:

docker run -d -e VERSION=SNAPSHOT ...

or a specific version:

docker run -d -e VERSION=1.7.9 ...

The message of the day, shown below each server entry in the UI, can be changed with the MOTD environment variable, such as

docker run -d -e 'MOTD=My Server' ...

The Java memory limit can be adjusted using the JVM_OPTS environment variable, where the default is the setting shown in the example (max and min at 1024 MB):

docker run -e 'JVM_OPTS=-Xmx1024M -Xms1024M' ...