English doc | Older version | 中文文档

A bedrock Minecraft PE Server on Docker

This documentation is for image lomot/minecraft-bedrock:1.19.10.20

Start the server

1. Install Docker in your server

apt install docker.io

or you can follow this documentation : How to install Docker

2. Create a folder for server data

This folder is for your world data and some configuration files, it contains permissions.json,server.properties,allowlist.json,worlds, if you use an empty folder, all the files will be created automatically, for example /opt/mcpe-data

mkdir -p /opt/mcpe-data

3. Deploy the server

docker run -itd --restart=always --name=mcpe --net=host \
  -v /opt/mcpe-data:/data \
  lomot/minecraft-bedrock:1.19.10.20

Upgrade the server

1. Backup your data

Backup the folder /opt/mcpe-data

cp -r /opt/mcpe-data /opt/mcpe-data.bak

2. Exit and delete the old container

docker container stop mcpe
docker container rm mcpe

3. Start a new container

docker run -itd --restart=always --name=mcpe --net=host \
  -v /opt/mcpe-data:/data \
  lomot/minecraft-bedrock:1.19.10.20

Manage the server

Enter or quit the game console

docker attach mcpe

To quit, press ctrl + p + q

Use ctrl + c or ctrl + dto kill the process

Use this command to stop/start/restart/rm the server

docker container stop/start/restart/rm mcpe

Change the server port

To change the server port, update server-port in the fileserver.properties

Using bridge networks will decrease the network performance, it is supposed to use host networks.

About addons, behavior_packs and resource_packs

There are too many files about addons to configure, so I made another image, to use this image, you need to manage server folder by yourself, such as update and configuration files, you can download the server files here Minecraft server.

How to use:

docker run -itd --restart=always --name=mcpe --net=host \
  -v /opt/mcpe-data:/mcpe \
  lomot/minecraft-bedrock:base

Binary file from

https://minecraft.net/en-us/download/server/bedrock/

Docker Hub

https://hub.docker.com/r/lomot/minecraft-bedrock

Github

https://github.com/LomotHo/minecraft-bedrock