This repository contains a Minecraft server with the Forge modding tools installed for Docker. Docker containers are immutable instances therfore any changes you make to your Server across restarts will be lost. To save the state of your ensure the following container volumes are mapped to a local folder:
- /minecraft/world - Main world save data
- /minecraft/config - Main configuration folder for the server and modules
Access to the minecraft server is typically configured through the banning ips, whitelisting players, and banning players. Since the configuration files for these
options ares stored in the main Minecraft folder /minecraft, these settings would be lost after a container restart. To solve this problem this Docker image links the following files to the /minecraft/config folder:
- banned-ips.json
- banned-players.json
- usercache.json
- whitelist.json
To see a demo of this Image being deployed to Azure Container Images, checkout episode 1 of HashiCraft.
https://www.youtube.com/watch?v=zL4Xt7CyuDE&t=1s
Configuration of the Mincraft server is completed through the following Environment variables:
Download a world backup archive in tar.gz format from the given URL and copy the contents to /minecraft/world when the server starts.
Note: This operation will only take place when the /minecraft/world folder is empty
WORLD_BACKUP=https://github.com/nicholasjackson/hashicraft/releases/download/v0.0.0/world2.tar.gz
Download a compressed folder in tar.gz format containing Minecraft mods and extract to /minecraft/mods when the server starts.
Note: This operation will only take place when the /minecraft/world folder is empty
MODS_BACKUP=https://github.com/nicholasjackson/hashicraft/releases/download/v0.0.0/mods.tar.gz
Download a compressed folder in zip format containing Minecraft resource pack, clients joining the server who have resource packs enabled will automatically download and apply this resource pack.
RESOURCE_PACK=https://github.com/HashiCraft/terraform_minecraft_azure_containers/releases/download/files/KawaiiWorld1.12.zip
Configures how much memory is allocated to the Java virtual machine.
JAVA_MEMORY=4
Port which the Minecraft server listens on.
MINECRAFT_PORT=25565
Enable the Nether underworld for the server
ALLOW_NETHER=true
Message of the day presented to users when they log in.
MINECRAFT_MOTD="Welcome to the Minecraft server"
Port which the RCon remote admin server listens on.
RCON_PORT=27015
Is the RCon remote admin server enabled?
RCON_ENABLED=true
Password to access the remote RCon server.
Note: You should always use a strong password when your server is connected to the public internet.
RCON_ENABLED=3fdf32dss29$#c1
Enable the Minecraft server player whitelist?
Note: You should always enable the whitelist when a server is connected to the public internet.
Users can be added to the whitelist using the following command from either the server or RCom terminal.
whitelist add <USERNAME>
WHITELIST_ENABLED=true
docker run \
--rm \
-it \
-p 25565:25565 \
-p 27015:27015 \
-v ${PWD}/world:/minecraft/world \
-v ${PWD}/config:/minecraft/config \
-e "MINECRAFT_MOTD=Hello World" \
-e "RCON_ENABLED=true" \
-e "RCON_PASSWORD=password" \
-e "WORLD_BACKUP=https://github.com/nicholasjackson/hashicraft/releases/download/v0.0.0/world2.tar.gz" \
hashicraft/minecraft:v1.12.2Install Shipyard https://shipyard.run
➜ shipyard run ./blueprint
Running configuration from: ./
2020-04-09T09:12:28.504+0100 [DEBUG] Statefile does not exist
2020-04-09T09:12:28.504+0100 [INFO] Creating Container: ref=minecraft
2020-04-09T09:12:28.562+0100 [DEBUG] Image exists in local cache: image=hashicraft/minecraft:latest
2020-04-09T09:12:28.562+0100 [INFO] Creating Container: ref=minecraft
On initialization the Docker container will download the world and mods and copy these to your local disk:
- ./mc_server/mods == Mine craft mods
- ./mc_server/world == Mine craft world
To reset a world to its default state simply remove the contents of ./mc_server/world
- Minecraft Chromium Embedded
- Web Displays
- Voice Chat (also requires Client install, https://github.com/hashicraft/mc/releases/download/v0.0.1/mods.zip)
➜ docker logs -f minecraft.container.shipyard.run
Installing default world
Installing default mods
2020-04-09 08:14:16,220 main WARN Disabling terminal, you're running in an unsupported environment.
[08:14:16] [main/INFO] [LaunchWrapper]: Loading tweak class name net.minecraftforge.fml.common.launcher.FMLServerTweaker
The server can be administered with RCom, to run the RCom CLI use the following command
shipyard exec container.minecraft -- rcon-cli --password=password
> /help
To make changes to the docker image you can modify the Dockerfile and entrypoint.sh script then build a new container
docker build -t hashicraft/minecraft:latest
If you would like to expose your server to the Outside world NGrok is a great tool https://ngrok.com/.
Install ngrok from https://ngrok.com/
Create a remote port for your local minecraft server
ngrok tcp 25565
Session Status online
Account Nicholas Jackson (Plan: Free)
Version 2.3.35
Region United States (us)
Web Interface http://127.0.0.1:4040
Forwarding tcp://0.tcp.ngrok.io:17144 -> localhost:25565
Connections ttl opn rt1 rt5 p50 p90
0 0 0.00 0.00 0.00 0.00