bbriggs/bukkit repository overview

⁠Supported tags and respective Dockerfile links

⁠Simple Tags

⁠Docker Bukkit

A Docker Bukkit/Spigot server based on Alpine.

⁠Running the server

To start the server and accept the EULA in one fell swoop, just pass the EULA=true environment variable to Docker when running the container. I recommend mounting a directory from your host onto /data in the container to make map and server data persistent.

docker run -it -v /data:/data -p 25565:25565 -e EULA=true --name mc_server bbriggs/bukkit

⁠Spigot included

Yes, even though the repo's name is bukkit, we have included the lovely spigot server as well. To run the spigot server, supply it as an argument like so:

docker run -it -v /data:/data -p 25565:25565 -e EULA=true --name mc_server bbriggs/bukkit spigot

⁠Configuration

You can bring your own existing data + configuration and mount it to the /data directory when starting the container by using the -v option. You may also pass configuration options as environment variables like so:

docker run -it -e DIFFICULTY=2 -e MOTD="A non-standard message" -e SPAWN_ANIMALS=false bbriggs/bukkit

This container will only attempt generate a server.properties file if one does not already exist. If you would like to use the configuration tool, be sure that you are not providing a configuration file or that you also set FORCE_CONFIG=true in the environment variables.

⁠Environment Files

Because of the potentially large number of environment variables that you could pass in, you might want to consider using an environment variable file⁠.

Example:

# env.list
ALLOW_NETHER=false
level-seed=123456789
EULA=true

docker run -d -it --env-file env.list -v $(pwd)/data:/data -p 25565:25565 bbriggs/bukkit

⁠List of Environment Variables

A full list of server.properties settings and their corresponding environment variables is included below, along with their defaults

⁠Running a specific version

To run a specific version of Bukkit or Spigot, use a docker tag.

Example: docker run -it -v /data:/data -p 25565:25565 -e EULA=true --name mc_server bbriggs/bukkit:1.9.4 spigot