Minecraft: Pi Edition For Docker
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
RaspberryPiNews 7a55ac09fa Update 'debian/client/common/usr/bin/minecraft-pi' 3 days ago
build Rework Packaging 1 month ago
core Rework Packaging 1 month ago
debian Update 'debian/client/common/usr/bin/minecraft-pi' 3 days ago
mods Name Property + VTable Offsets 4 weeks ago
scripts Fix Launcher On Mobian (PinePhone) 1 month ago
.dockerignore Improve Comments 2 months ago
.gitignore Switch To 32-Bit Docker Image 1 month ago
CREDITS.md Add Smooth Lighting 1 month ago
Dockerfile.build Fix CI 3 months ago
Dockerfile.client Name Property + VTable Offsets 4 weeks ago
Dockerfile.server Remove XVFB From Dedicated Server 2 months ago
Jenkinsfile Port From SDL 1.2 To GLFW 3 months ago
LICENSE Add License 3 months ago
MODDING.md Fix Typo 3 weeks ago
README.md Update README 3 weeks ago


Minecraft: Pi Edition For Docker

This is a project allowing Minecraft: Pi Edition to be run without a Raspberry Pi using Docker.


  1. Remove Old Minecraft: Pi Edition Package If Installed (sudo apt remove minecraft-pi)
  2. Download Appropriate Package (See Table Below) From Here
  3. Install With sudo apt install ./<Path To File>


Package Description
minecraft-pi-server Minecraft Pi Edition Modded Into A Dedicated Server
minecraft-pi-virgl Minecraft Pi Edition Using VirGL For Hardware Acceleration (Recommended For Desktop)
minecraft-pi-native Minecraft: Pi Edition Using Docker Device Mounting For GPU Acceleration (Recommended For ARM Devices (ie. Raspberry Pi, PinePhone, etc))

General Notes

Docker Versions

While the distribution-provided version of Docker works fine on most systems, in rare cases it can be outdated and cause bugs. Before reporting a bug, try using the official builds of Docker. These can be installed by following your distribution's instructions at https://docs.docker.com/engine/install.

Specific Notes

Raspbian Buster

By default Raspbian Buster ships an older version of the package libseccomp2. This package is used to block certain dangerous system calls from running inside Docker containers. The included version accidentally blocks the system call clock_gettime64, this causes bugs inside Minecraft: Pi Edition. However, the Debian buster-backports repo includes an updated version. You can enable the buster-backports repo and update libseccomp2 by running:

# Install Backports Key
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 04EE7237B7D453EC
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 648ACFD622F3D138
# Install Backports Repository
echo 'deb http://deb.debian.org/debian buster-backports main' | sudo tee -a /etc/apt/sources.list
# Update APT Index
sudo apt update
# Install Updated libseccomp2
sudo apt install -t buster-backports libseccomp2

PinePhone (Mobian)

This supports running on a PinePhone using Mobian. However, you will need to attach a keyboard and mouse as Minecraft: Pi Edition does not have touch support.

Troubleshooting Crashes

Game logs are located in /tmp/minecraft-pi.

Error response from daemon: error gathering device information while adding custom device "/dev/dri": no such file or directory

Make sure you are using the correct GPU drivers for your system. If you are using a Raspberry Pi, make sure you have set your GPU driver to Full KMS or Fake KMS in raspi-config.

Segmentation Fault

  1. Attempt To Reproduce Issue And Record Instructions
  2. Report On Issue Tracker Including The Instructions To Reproduce

Dedicated Server

The dedicated server is a version of Minecraft: Pi Edition modified to run in a headless environment. It loads settings from a server.properties file.

To use, install the minecraft-pi-server package and run minecraft-pi-server. It will generate the world and server.properties in the current directory.

This is also compatible with MCPE 0.6.1.


  • Player data is not saved because of limitations with MCPE LAN worlds
    • An easy workaround is to place your inventory in a chest before logging off
  • Survival mode servers are only compatible with minecraft-pi-docker clients


View Modding


View Credits