fingerhutascode/minecraft-bedrock-server repository overview

⁠AdCraft's Minecraft Bedrock Server Docker Image

TL;DR: A self-updating Docker image for a Minecraft Bedrock dedicated server — drop a .mcworld file in a mods folder and it's live on boot. Jump to setup →⁠

⁠Why this exists

One of my kids loves Minecraft and, like every kid with a favorite streamer, wants whatever custom world or mod they just saw played — for about thirty minutes, until the next video changes their mind. They play on console, not PC, so anything beyond vanilla needs a server hosting it for them.

Manually re-provisioning a server every time the flavor of the week changes wasn't sustainable, especially over summer break. So instead: a vanilla, always-current Bedrock server image where "installing a mod" means dropping a file in a folder and restarting the container.

⁠What it does

• Builds a Bedrock Dedicated Server image on Arch Linux, running as a non-root user.
• Fetches the latest official Bedrock server binary at build time — rebuild the image and you're on the newest version, no manual URL/version bumping.
• On container boot, scans a mounted mods folder and installs anything it finds:
  • .mcworld files → extracted and set as the active world (level-name in server.properties is updated automatically).
• Everything lands where the actual bedrock_server binary expects it (worlds/, behavior_packs/, resource_packs/), so no extra wiring is needed after install.

⁠Coming soon

• .mcpack / .mcaddon (resource pack / behavior pack) installation is planned but not wired up yet — fetch-packs.py is a stub.

⁠Quick start

⁠1. Get the image

Pull the published image from Docker Hub⁠:

docker pull fingerhutascode/minecraft-bedrock-server

Or build it yourself from source on GitHub⁠:

./build.sh

⁠2. Point a folder at your mods

Put the .mcworld file(s) you want loaded into a local folder, e.g. ./mods/.

⁠3. Configure docker-compose.yml

services:
  bedrock:
    image: fingerhutascode/minecraft-bedrock-server:latest
    container_name: minecraft-bedrock-server
    restart: unless-stopped
    ports:
      - "19132:19132/udp"
    volumes:
      - ./mods:/home/minecraft/mods:ro

⁠4. Start it up

docker compose up -d

On boot, the container installs whatever it finds in mods/ and starts the server. To switch worlds, swap the file in mods/ and restart the container:

docker compose restart

⁠Configuration

⁠Directory layout

After a world with embedded packs is installed, the server root looks like:

/home/minecraft/
├── behavior_packs/
│   └── <pack-folder>/
├── resource_packs/
│   └── <pack-folder>/
└── worlds/
    └── <world-folder-name>/
        ├── level.dat
        ├── world_behavior_packs.json
        ├── world_resource_packs.json
        └── db/

⁠Credits

Bedrock server version discovery in fetch-server.sh uses kittizz's bedrock-server-downloads⁠ feed.