onmomo/minecraft-education-server repository overview

⁠onmomo/minecraft-education-server

Docker image for the official Minecraft Education dedicated server (Linux).

• Bundle downloaded from Microsoft's CDN at build time — image stays in sync with upstream releases.
• Worlds, server.properties, allowlist, permissions, and the edu_server_session.json credential file persist on a host volume (/data).
• Editable defaults are seeded on first run; read-only assets (behavior packs, resource packs, definitions, the binary) are symlinked from the image so version upgrades flow through cleanly.
• Non-root, tini-managed init, signal-clean shutdowns.
• The bedrock_server_edu binary is x86_64-only; Apple Silicon hosts run it under Rosetta.

⁠Tags

Currently published: mee-1.21.133.2.

⁠Quick start

mkdir -p data
docker run -d --name minecraft-edu --platform linux/amd64 \
  --restart unless-stopped \
  -p 20202:20202/udp -p 19132:19132/udp \
  -v "$PWD/data:/data" -it \
  onmomo/minecraft-education-server:latest

Watch the logs for the Microsoft device-code sign-in prompt on first start:

docker logs -f minecraft-edu

After a tenant Global Admin completes auth at the printed device-login URL, the server writes data/edu_server_session.json and silently refreshes its token on subsequent restarts.

⚠️ The default server-public-ip=localhost only works if client and server are on the same machine. Edit data/server.properties — its inline comments explain the LAN / public-IP cases. Restart to apply.

⁠Configuration

After first start, edit files under ./data/ and docker restart minecraft-edu:

Worlds live under ./data/worlds/<level-name>/.

⁠Source

Wrapper code, full documentation, and release notes: https://github.com/onmomo/minecraft-education-server⁠