flyingratbull/minecraft-craftbukkit-server

CraftBukkit Minecraft server

Basic https://www.docker.com/ image with a CraftBukkit Minecraft server. The images are based of https://hub.docker.com/r/ofayau/ejre/ and https://hub.docker.com/_/alpine/ to keep image sizes as small as possible.

Quickstart

To get the server with the latest version running quickly, use:

$ docker run \
    --name minecraft-server \
    -P -t -d flyingratbull/minecraft-craftbukkit-server

You can then connect to it in Minecraft withe the hostname "localhost".

How to use this image

You should configure your server first (i.e. to add OPs, whitelist players etc.) by running the server in interactive mode:

$ docker run -ti flyingratbull/minecraft-craftbukkit-server

This will bring you to the interactive Minecraft server console. The commands can be found on the official Minecraft and the CraftBukkit sites.

After successful configuration you can start the Minecraft server simply by running:

$ docker run -p HOST_PORT:25565 -t -d flyingratbull/minecraft-craftbukkit-server

This will start a 64 bit Minecraft server of the latest available version which will listen on the port HOST_PORT.

If you want to customize parameters of either the Java Virtual Machine or the Minecraft server, you can use some environment variables:

$ docker run -p HOST_PORT:25565 \
    -e JAVA_PARAMS="-server" \
    -e JAVA_MAX_MEM="1024M" \
    -e SERVER_PARAMS="nogui" \
    -t -d flyingratbull/minecraft-craftbukkit-server

If you want to access the volume in which the world data is stored (i.e. to backup data which is highly recommended), you can moutn a volume as following:

$ docker run \
    -v HOST_PATH:/mnt/data \
    -t -d flyingratbull/minecraft-craftbukkit-server

To let the server run in the same timezone as the host you can do the following on Linux:

$ docker run -p HOST_PORT:25565 \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -t -d flyingratbull/minecraft-craftbukkit-server

Here is the full sized command:

$ docker run -p HOST_PORT:25565 \
    -e JAVA_PARAMS="-server" \
    -e JAVA_MAX_MEM="1024M" \
    -e SERVER_PARAMS="nogui" \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -v HOST_PATH:/mnt/data \
    -t -d flyingratbull/minecraft-craftbukkit-server

Tags

For each supported Minecraft server version there are the following tags:

• latest: Latest available Minecraft CraftBukkit server version (64 bit JVM)
• latest_x86: Latest available Minecraft CraftBukkit server version (32 bit JVM)
• [VERSION]: 64 bit JVM
• [VERSION]_x86: 32 bit JVM (lower memory usage but maybe little more CPU usage)

Environment variables

The following environment variables currently are supported:

• JAVA_PARAMS: Java VM parameters (default: -server)
• JAVA_MAX_MEM: Maximum Java VM memory (Xmx) (default: 1024M)
• SERVER_PARAMS: Minecraft CraftBukkit server parameters (default: nogui)

Volumes

The following volumes are defined and can be used accordingly:

• /mnt/data: The minecraft data folder which contains all world data, plugins and config files

Disclaimer

It should be understood that Minecraft content and materials are trademarks and copyrights of Mojang AB or its licensors. All rights reserved. This software is a personally created product and is not affiliated with Mojang AB.