Minecraft server SPIGOT on Ubuntu 16.04 with openjava 1.8
This docker image builds and runs the spigot version of minecraft.
If the spigot.jar is not found in the minecraft directory the system pulls down BuildTool and build a new spigot.jar from the latest
Each time the container is started the presence of the file /minecraft/spigot.jar, if the file is missing a build of spigot.jar is started.
The spigot daemon is started with superovisord, see my Ubuntu container for a more detailed description of my implementation of an init-process in ubuntu, see nimmis/ubuntu
Whats new is
- adjust minecraft user UID to match mounted volume
- selectable memory size for the Java process
- selectable spigot version
- do a nice shutdown of the server when the docker stop command is issued
- docker accessible commands to
- start/stop/restart the spigot server
- send console commands to the server
- look at console output from the server
Why not a precompiled version of spigot is included
Due to legal reasons you can build it yourself but you can't redistribute the finished jar file.
Starting the container
To run the latest stable version of this docker image run
docker run -d -p 25565:25565 -e EULA=true nimmis/spigot
The is because Mojang now requires the end user to access their EULA, located at
https://account.mojang.com/documents/minecraft_eula, the be able to start the server.
tell on witch external port the internal 25565 should be connected, in this case the same, if
you only type -p 25565 it will connect to a random port on the machine
Giving the container a name
To make it easier to handle you container you can give it a name instead of the long
number thats normally give to it, add a
to the run command to give it the name minecraft, then you can start it easier with
docker start spigot docker stop spigot
First time run
This will take a couple of minutes depending on computer and network speed. It will pull down
the selected version on BuildTools and build a spigot.jar from the selected minecraft version.
This is done in numerous steps so be patient.
you can follow the output from the compilation with then command (assume that you given the container
the name spigot)
docker logs -f spigot *** open logfile *** Run files in /etc/my_runonce/ *** Running /etc/my_runonce/set_timezone... *** Run files in /etc/my_runalways/ *** Running /etc/my_runalways/do_build_spigot... --2016-12-04 13:17:37-- https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar Resolving hub.spigotmc.org (hub.spigotmc.org)... 184.108.40.206, 220.127.116.11, 2400:cb00:2048:1::681b:c360, ... Connecting to hub.spigotmc.org (hub.spigotmc.org)|18.104.22.168|:443... connected. HTTP request sent, awaiting response... 200 OK
Then the compilation is completed the server will start and you will see something like
*** Log: Success! Everything compiled successfully. Copying final .jar files now. *** Log: Copying craftbukkit-1.11-R0.1-SNAPSHOT.jar to /minecraft/build/. *** Log: - Saved as craftbukkit-1.11.jar *** Log: Copying spigot-1.11-R0.1-SNAPSHOT.jar to /minecraft/build/. *** Log: - Saved as spigot-1.11.jar *** Running /etc/my_runalways/eula... *** Running /etc/rc.local... *** Booting supervisor daemon... *** Supervisor started as PID 4820 *** Started processes via Supervisor...... crond RUNNING pid 4824, uptime 0:00:03 spigot RUNNING pid 4825, uptime 0:00:03 syslog-ng RUNNING pid 4823, uptime 0:00:03
you can then exit from the log with CTRL-C
Selecting version to compile
If you don't specify it will always compile the latest version but if you want a specific version you can specify it by adding
-e SPIGOT_VER <version>
where <version> is the version you would like to use, to build it with version 1.8 add
-e SPIGOT_VER 1.8
to the docker run line.
The following version is atm avaliable 1.8, 1.8.3, 1.8.7, 1.8.8, 1.9, 1.9.2 and latest. Please check
the web page for BuildTools to get the latest information.
setup memory to use
There are two environment variables to set maximum and initial memory for spigot.
Sets the maximum memory to use <size>m for Mb or <size>g for Gb, if this parameter is not set 1 Gb is chosen, to set the maximum memory to 2 Gb
sets the initial memory reservation used, use <size>m for Mb or <size>g for Gb, if this parameter is not set, it is set to MC_MAXMEM, to set the initial size t0 512 Mb
This variable controlls the behavior of the container when the stop command is issued inside minecraft
Which is the default behavior and does not need to be specified, the minecraft server will autostart if the stop command is issued.
If the stop command is issued the minecraft server will stay down until the container is restarted or the command mc_start is issued
look at the last output from the spigot server
To get an output of the latest events from the spigot server type
docker exec spigot mc_log
and you will see the last 10 lines from the output, this is what you will see after startup
Abort with CTRL-C [13:02:15 INFO]: Zombie Aggressive Towards Villager: true [13:02:15 INFO]: Experience Merge Radius: 3.0 [13:02:15 INFO]: Preparing start region for level 0 (Seed: 506255305130990210) [13:02:16 INFO]: Preparing spawn area: 22% [13:02:17 INFO]: Preparing spawn area: 99% [13:02:17 INFO]: Preparing start region for level 1 (Seed: 506255305130990210) [13:02:18 INFO]: Preparing spawn area: 95% [13:02:18 INFO]: Preparing start region for level 2 (Seed: 506255305130990210) [13:02:18 INFO]: Server permissions file permissions.yml is empty, ignoring it [13:02:18 INFO]: Done (3.650s)! For help, type "help" or "?"
It will continue to output everything from the console until you press CTRL-C
sending commands to the server console
You don't need to have an interactive container to be able to send commands to the console. To send
a command to set the time to day you type
docker exec spigot mc_send "time set day"
If this was the first command issued after a start the output should look like
[13:02:15 INFO]: Zombie Aggressive Towards Villager: true [13:02:15 INFO]: Experience Merge Radius: 3.0 [13:02:15 INFO]: Preparing start region for level 0 (Seed: 506255305130990210) [13:02:16 INFO]: Preparing spawn area: 22% [13:02:17 INFO]: Preparing spawn area: 99% [13:02:17 INFO]: Preparing start region for level 1 (Seed: 506255305130990210) [13:02:18 INFO]: Preparing spawn area: 95% [13:02:18 INFO]: Preparing start region for level 2 (Seed: 506255305130990210) [13:02:18 INFO]: Server permissions file permissions.yml is empty, ignoring it [13:02:18 INFO]: Done (3.650s)! For help, type "help" or "?" [13:12:35 INFO]: Set the time to 1000
It will continue to output everything from the console until you press CTRL-C
using the minecraft op command
To make yourself operator in the game use mc_send command, for example give the user myuser op use the command.
using the minecraft stop command
Default the minecraft server will automatically restart on a stop inside the minecraft application. You can override this behavior by using
This will prevent the server to restart and minecraft has to be started again with the mc_start command
docker exec spigot mc_send op myuser
starting and stopping the server
To stop the server but not the container do
docker exec spigot mc_stop
To start it after being stopped do
docker exec spigot mc_start
Finally to restart it do
docker exec spiot mc_restart
stopping the container
When the container is stopped with the command
docker stop spigot
the spigot server is shutdown nicely with a console stop command to give it time to save everything before
stopping the container. If you look in the output from the server this show
[13:01:51 INFO]: Stopping the server [13:01:51 INFO]: Stopping server [13:01:51 INFO]: Saving players [13:01:51 INFO]: nimmis lost connection: Server closed [13:01:51 INFO]: nimmis left the game. [13:01:51 INFO]: Saving worlds [13:01:51 INFO]: Saving chunks for level 'world'/Overworld [13:01:51 INFO]: Saving chunks for level 'world_nether'/Nether [13:01:51 INFO]: Saving chunks for level 'world_the_end'/The End
Having the minecraft files on the host machine
If you delete the container all your filer in minecraft will be gone. To save them where it's
easier to edit and do a backup of the files you can attach a directory from the host machine
(where you run the docker command) and attach it to the local file system in the container.
The syntax for it is
To attach the minecraft directory in the container to directory /home/nimmis/mc-srv you add
problems with external mounted volumes
When a external volume is mounted the UID of the owner of the volume may not match the UID of the minecraft user (1000). This can result in problems with write/read access to the files.
To address this problem a check is done between UID of the owner of /minecraft and the UID of the user minecraft. If there is a mismatch the UID of the minecraft user is changed to match the UID of the directory.
If you don't want to do this and want to manually set the UID of the minecraft user there is a variable named SPIGOT_UID which defines the minecraft user UID, adding
sets the minecraft user UID to 1132.
If you have any problems with or questions about this image, please contact us by submitting a ticket through a GitHub issue
- Look to see if someone already filled the bug, if not add a new one.
- Add a good title and description with the following information.
- if possible an copy of the output from cat /etc/BUILDS/* from inside the container
- any logs relevant for the problem
- how the container was started (flags, environment variables, mounted volumes etc)
- any other information that can be helpful
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
- automatic backup