Legendary Minecraft Bedrock Container

Minecraft Bedrock Docker Edition
Minecraft Bedrock Docker Edition

I’ve been getting asked to put this together for years including in official GitHub issues. I always knew it would be a great idea but it turned out even better than I expected. This image works great on all platforms including Raspberry Pi!

This is based off my Minecraft Bedrock Linux Dedicated Server scripts for Linux project. I’m going to release a version for the Java Minecraft edition as well so stay tuned for that.

The official GitHub repository is located here.

The official Docker Hub repository is located here.

If you are looking for the Java version of the Docker container it is located here. This is for the Bedrock edition of Minecraft.

You can also run my Geyser + Floodgate Java Minecraft Server container and Bedrock players will be able to connect to it!

Features

  • Sets up the official Minecraft Bedrock Server (currently in alpha testing)
  • Fully operational Minecraft Bedrock edition server in a couple of minutes
  • Adds logging with timestamps to “logs” directory
  • Multiarch Support – all Docker platforms supported including Raspberry Pi
  • Automatic backups when container/server restarts
  • Supports multiple instances — you can run multiple Bedrock servers on the same system
  • Updates automatically to the latest or user-defined version when server is started
  • Files stored in named Docker volume allowing for extremely easy access/editing and leveraging more advanced Docker features such as automatic volume backups
  • *NEW* – Box64 support added for improved speeds on aarch64 (ARM 64 bit)

Usage

First you must create a named Docker volume. This can be done with:

docker volume create yourvolumename

Now you may launch the server and open the ports necessary with one of the following Docker launch commands.

With default ports:

docker run -it -v yourvolumename:/minecraft -p 19132:19132/udp -p 19132:19132 -p 19133:19133/udp -p 19133:19133 05jchambers/legendary-bedrock-container:latest

With custom ports:

docker run -it -v yourvolumename:/minecraft -p 12345:12345/udp -p 12345:12345 -p 12346:12346/udp -p 12346:12346 -e PortIPV4=12345 -e PortIPV6=12346 05jchambers/legendary-bedrock-container:latest

IPV4 only:

docker run -it -v yourvolumename:/minecraft -p 19132:19132/udp -p 19132:19132 05jchambers/legendary-bedrock-container:latest

Configuration / Accessing Server Files

The server data is stored where Docker stores your volumes. This is typically a folder on the host OS that is shared and mounted with the container. I’ll give the usual locations here but if you’re having trouble just do some Googling for your exact platform and you should find where Docker is storing the volume files.

You can find your exact path by typing:

docker volume inspect yourvolumename

This will give you the fully qualified path to your volume like this:

{
        "CreatedAt": "2022-05-09T21:08:34-06:00",
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/yourvolumename/_data",
        "Name": "yourvolumename",
        "Options": {},
        "Scope": "local"
}

On Linux it’s typically available at:

/var/lib/docker/volumes/yourvolumename/_data

On Windows it’s at

C:\ProgramData\DockerDesktop

but may be located at something more like

\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes\

if you are using WSL (Windows Subsystem for Linux).



On Mac it’s typically

~/Library/Containers/com.docker.docker/Data/vms/0/

If you are using Docker Desktop on Mac then you need to access the Docker VM with the following command first:

screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty

You can then normally access the Docker volumes using the path you found in the first step with docker volume inspect

Most people will want to edit server.properties. You can make the changes to the file and then restart the container to make them effective.

Backups are stored in the “backups” folder

Log files with timestamps are stored in the “logs” folder.

Version Override

In some scenarios you may want to run a specific version of the Bedrock server. That is now possible by using the “Version” environment variable:

-e Version=1.18.33.02

For example:

docker run -it -v yourvolumename:/minecraft -e Version=1.18.33.02 -p 19132:19132/udp -p 19132:19132 05jchambers/legendary-bedrock-container:latest

This is useful if Microsoft hasn’t released versions of the client and dedicated server at the same time so you can match whichever version your players can connect with.

Clean Environment Variable

If the server is having trouble starting you can clean the downloads folder and force reinstallation of the latest version like this:

docker run -it -v yourvolumename:/minecraft -e Clean=Y -p 19132:19132/udp -p 19132:19132 05jchambers/legendary-bedrock-container:latest

This is useful if a download corrupted or something modified your container contents as it will clear everything out and reinstall the latest Bedrock server fresh.

Disable Box64 (aarch64 only):

If you are having trouble running the dedicated server with Box64 support you can tell it to use QEMU instead with:

-e UseQEMU=Y

For example:

docker run -it -v yourvolumename:/minecraft -e UseQEMU=Y -p 19132:19132/udp -p 19132:19132 05jchambers/legendary-bedrock-container:latest

Troubleshooting Note – Oracle Virtual Machines

A very common problem people have with the Oracle Virtual Machine tutorials out there that typically show you how to use a free VM is that the VM is much more difficult to configure than just about any other product / offering out there.

It is because there are several steps you need to take to open the ports on the Oracle VM. You need to both:

  • Set the ingress ports (TCP/UDP) in the Virtual Cloud Network (VCN) security list
  • *and* set the ingress ports in a Network Security Group assigned to your instance

Both of these settings are typically required before you will be able to connect to your VM instance. This is purely configuration related and has nothing to do with the script or the Minecraft server itself.

I do not recommend this platform due to the configuration difficulty but the people who have gone through the pain of configuring an Oracle VM have had good experiences with it after that point. Just keep in mind it’s going to be a rough ride through the configuration for most people.

Troubleshooting Note – Hyper-V

There is a weird bug in Hyper-V that breaks UDP connections on the Minecraft server. The fix for this is that you have to use a Generation 1 VM with the Legacy LAN network driver.

Additional Support

The comments section right here is the best place for support. The second best place is the GitHub issues section.

I will add additional documentation based on what problems people are running into / questions people are asking because right now I’m not really sure what those will be yet. Definitely let me know if you need any of these things!

guest

59 Comments
Inline Feedbacks
View all comments

Topher M
Topher M
2 months ago

Hi… after setting up docker and running your script, terminal returns “Starting Minecraft Server” and then immediately terminates the screen session. Not certain what I am doing wrong.

This is a VM on Oracle running Ubuntu 20.04.

Topher M
Topher M
2 months ago
Reply to  jamesachambers

Ah ok, well I didn’t intend to create more work for you, but I (and my minecrafting nephews) thank you for the work you do and the generosity with which you offer it to the internet!

Topher M
Topher M
2 months ago
Reply to  jamesachambers

I got it working! Takes a few minutes to connect, but seems to ruin smoothly otherwise. Thank you very much!

Tfes
Tfes
2 months ago

I have followed the instructions, I believe, but don’t seem to get the server to restart when I reboot (I tried to reboot the machine to pick up new server.properties changes).

I also don’t appear to have any containers within docker (docker container ls) and found my docker volumes in /var/snap/docker/common/var-lib-docker/volumes/minecraft1/_data. Does this suggest I did something wrong?

Also interested in running multiple instances for different worlds… any hints? (First time with docker- can you tell?!)

SolarSciencePup
SolarSciencePup
3 months ago

I am having an issue where the server changes port first it goes to the correct port but then it changes port also it appears not to want to use IPv6

Logs:
minecraftbe [2022-07-03 07:31:06] [2022-07-03 07:31:06:844 INFO] IPv4 supported, port: 19132
minecraftbe [2022-07-03 07:31:06] [2022-07-03 07:31:06:859 INFO] IPv6 not supported
minecraftbe [2022-07-03 07:31:14] [2022-07-03 07:31:14:471 INFO] IPv4 supported, port: 50093
minecraftbe [2022-07-03 07:31:14] [2022-07-03 07:31:14:472 INFO] IPv6 not supported

SolarSciencePup
SolarSciencePup
2 months ago
Reply to  jamesachambers

Thanks!

BlueFrog
BlueFrog
3 months ago

A truly awesome article, dockerizing the server is a great idea. It sucks that Microsoft doesn’t support ARM.

Similar to Dea7h, I am having an issue loading into the server once I get it running. I get stuck on “Locating server…” for quite some time, then once I get into the server, the performance is dreadful.

I have Ubuntu 22. 64bit loaded up on a 4GB Raspberry Pi 4. Any performance tips?

Dea7h
Dea7h
3 months ago

Things you might want to mention above… or just allow people to scroll down to the comments. 😉
* It took me *ages* to fix my docker containers failing to connect to the internet [1]. Fixed by setting “date” properly [2].
* The Docker instructions for how to magically “–restart” your containers [3]. I go with “always”, then “update” when I need to bring it down for maintenance.

However, I’m still getting “Locating server…” issues, possibly the same as what Ishann [4] did. It’s an RPi4, probably using a default memory split. Not sure what I need to fix/tweak/update. I’ll start with the OS… I think I’m running an old 32-bit Raspbian.

[1] https://www.reddit.com/r/docker/comments/oxz0w9/docker_containers_dont_have_internet_connection/
[2] https://docs.linuxserver.io/faq#libseccomp
[3] https://docs.docker.com/config/containers/start-containers-automatically/
[4] https://jamesachambers.com/official-minecraft-bedrock-dedicated-server-on-raspberry-pi/

Firebourne
Firebourne
3 months ago

This container is truly awesome. Currently I am having issues with the docker container exiting and Ubuntu crashing with disk errors (on an SDD). Is the best course to simply copy the world and reimage the machine with 22.04 (what we are currently running)?

Such a simple thing, I am amazed that the whole machine is so unstable. I’m running this server on a laptop with nothing else running that I built just for this.

Rajdeep
Rajdeep
3 months ago

I followed the installation steps on oracle cloud VPS, but I cannot connect to the server. I’ve allowed traffic from both ports in oracle and ubuntu 20.04 VM(ufw)

CPU – Ampeare, ARM64. RAM – 6gb.