Published on

Run a Minecraft Server with Docker Compose

Authors

minecraft

This post will show how to setup your own minecraft game server on docker using docker-compose.

Requirements

As we will run minecraft as a docker container, we require docker and docker-compose. You can follow the links to their website for instructions to install it.

In summary it will be the following to install docker:

curl https://get.docker.com | bash
sudo usermod -aG docker $USER

And the following to install docker-compose:

sudo curl -L "https://github.com/docker/compose/releases/download/1.28.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Note that I installed version 1.28.5, in future this may be outdated, so I recommend getting the latest version from their website.

You can verify if docker and docker-compose was installed by running:

docker --version
docker-compose --version

Configuration

Create the project directory:

mkdir -p ~/mincraft

Change to the directory:

cd ~/minecraft

Create the docker-compose.yml file and open it with your editor of choice, then provide this content:

version: "3.8"

services:
  minecraft-server:
    image: itzg/minecraft-server:latest
    container_name: minecraft-server
    ports:
      - 25565:25565
    environment:
      SERVER_NAME: "Dockerized-Minecraft-Server"
      MOTD: "Forge Minecraft Server"
      EULA: "TRUE"
      TYPE: "FORGE"
      VERSION: "1.17.1"
      MODE: "survival"
      MEMORY: "1G"
      LEVEL_TYPE: "DEFAULT"
      ENABLE_RCON: "true"
      RCON_PASSWORD: password
      RCON_PORT: 28016
      SERVER_PORT: 25565
      ENABLE_WHITELIST: "true"
      WHITELIST: "${WHITELISTED_PLAYERS}"
      OPS: "${OPS_PLAYERS}"
      MAX_PLAYERS: 20
      ANNOUNCE_PLAYER_ACHIEVEMENTS: "true"
      SPAWN_ANIMALS: "true"
      SPAWN_MONSTERS: "true"
      PVP: "true"
      LEVEL: "cold"
      TZ: "Africa/Johannesburg"
      GUI: "FALSE"
      MODS_FILE: /extras/mods.txt
      REMOVE_OLD_MODS: "true"
    restart: unless-stopped
    user: "${UID}:${GID}"
    volumes:
      - ./data:/data
      - ./mods.txt:/extras/mods.txt:ro
    logging:
      driver: "json-file"
      options:
        max-size: "1m"

We want the user creating the data directory to be the same user that we are using to avoid permission issues, so we need to create a .env file and set the UID and GID values to the userid and groupid of our user:

echo UID=$(id -u) > .env
echo GID=$(id -g) >> .env

Yours will most probably differ, but mine look like this:

cat .env
UID=501
GID=20

Next we need to set the whitelisted and ops players in WHITELISTED_PLAYERS and OPS_PLAYERS so the end result will look something like this:

UID=501
GID=20
WHITELISTED_PLAYERS=mygamertag,player2,player3
OPS_PLAYERS=mygamertag

If you don't want mods, you can remove MODS_FILE and REMOVE_OLD_MODS entry, but in this case I will be installing the Fast Leaf Decay mod from curseforge.com.

Create the file ~/minecraft/mods.txt and add the jar that you want to add to the file, as example:

https://media.forgecdn.net/files/3399/353/FastLeafDecay-26.jar

Start the Minecraft Server

Once that is in place, start the minecraft server:

docker-compose up -d

While the server is booting, you can follow the logs:

docker-compose logs -f minecraft-server
...
minecraft-server      | [12:18:55] [modloading-worker-1/INFO]: Forge mod loading, version 37.0.103, for MC 1.17.1 with MCP 20210706.113038
minecraft-server      | [12:18:55] [modloading-worker-1/INFO]: MinecraftForge v37.0.103 Initialized
minecraft-server      | [12:19:00] [main/INFO]: Reloading ResourceManager: Default, forge-1.17.1-37.0.103-universal.jar, FastLeafDecay-26.jar
minecraft-server      | [12:19:06] [Server thread/INFO]: Starting Minecraft server on *:25565
minecraft-server      | [12:19:10] [Server thread/INFO]: Preparing level "cold"
minecraft-server      | [12:19:12] [Worker-Main-2/INFO]: Preparing spawn area: 0%
minecraft-server      | [12:19:18] [Worker-Main-2/INFO]: Preparing spawn area: 9%
minecraft-server      | [12:19:19] [Worker-Main-2/INFO]: Preparing spawn area: 23%
minecraft-server      | [12:19:20] [Server thread/INFO]: Time elapsed: 9527 ms
minecraft-server      | [12:19:20] [Server thread/INFO]: Done (9.928s)! For help, type "help"
minecraft-server      | [12:19:20] [Server thread/INFO]: Starting remote control listener
minecraft-server      | [12:19:20] [Server thread/INFO]: Thread RCON Listener started
minecraft-server      | [12:19:20] [Server thread/INFO]: RCON running on 0.0.0.0:28016
minecraft-server      | [20:19:20] [RCON Listener #1/INFO]: Thread RCON Client /172.19.0.3 started

Once the server is booted, we can verify by using the healthcheck command:

docker exec -it minecraft-server mc-monitor status

localhost:25565 : version=1.17.1 online=0 max=20 motd='Forge Minecraft Server'

Minecraft Command Line

We can access the minecraft command line with the following:

docker-compose exec minecraft-server rcon-cli
>

To list our whitelisted players:

> /whitelist list
There are 3 whitelisted players: x, x, x

To restart the server:

> /stop

Install Minecraft

Install minecraft java edition on your PC from:

Once installed, install the forge client:

Open minecraft and you should see the forge under our installations:

minecraft

When we run our forge installation you should see something like this:

minecraft

Then on the multiplayer section you should see the servers below:

minecraft

You will most probably have no servers by default, so then add your server, you will need the IP Address of where minecraft is running:

minecraft

Save it and join your server and you should be connected to your server.

Note on Forge Mods

For forge mods to work properly you need the mods on the server and client side, for more info, see this issue:

Backups

Create the directories for the script and backup locations:

sudo mkdir -p /opt/backups /opt/scripts

Change the permissions of those directories:

sudo chown -R "$(id -u):$(id -g)" /opt

Create the backup script in /opt/scripts/backup_minecraft.sh with the following content:

#!/usr/bin/env bash
tar -zcvf /opt/backups/minecraft/backup-$(date +%F).tar.gz ~/minecraft
find /opt/backups/minecraft/ -type f -name "backup-*.tar.gz" -mtime +7 -exec rm {} \;

This script will compress the minecraft project directory in a archive and delete any backups older than 7 days, which we will run under a cronjob.

Change the permissions of our backup script to make it executable:

chmod +x /opt/scripts/backup_minecraft.sh

Open crontab with crontab -e and add the cron expression to backup daily at 00:00:

00 00 * * * /opt/scripts/backup_minecraft.sh

Getting Started Guide

This is a nice tutorial I stumbled upon for getting started:

minecraft-tutorial

Thank You

Thanks for reading, if you like my content, feel free to check out my website, and subscribe to my newsletter or follow me at @ruanbekker on Twitter.

Join my Newsletter?
Buy Me A Coffee
Discuss on Twitter • View on GitHub