itzg / itzg/docker-minecraft-bedrock-server

Exit Code -1 on Raspberry Pi 5 - Regression in recent image build

Open
#599 6 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
1.9k
Forks
303
Avg merge
2h 26m
Merged PRs (30d)
2

Description

**Technical Facts:**

- Hardware: Raspberry Pi 5 (8GB) running 64-bit OS with 16KB page size (Verified via getconf PAGESIZE).
- Failure observed on Image Tag: 2026.2.0
- Working Image Tag: 2025.12.2
- Error: SIGSEGV at x64pc=0x30000080/"box64/ExitEmulation".

**Observed Behavior:**

- The container using the 2026.2.0 tag (currently latest) fails immediately upon execution of the Bedrock binary.
- The Box64 log confirms it is running on a Cortex-A76 with 16384 pagesize.
- The crash occurs before the Minecraft server can initialize its own logs.
- Cleared all binaries and .so files to force a clean download, but the issue persists.
- Reverting to image 2025.12.2 resolves the issue and allows the server to start normally on the same host and kernel.

**Steps to Reproduce:**

1. Run the image on a Raspberry Pi 5 with the default 16k page size kernel.
2. Set VERSION=LATEST (currently 1.26.1.1).
3. The server exits with code -1.

Note: Raspberry Pi 5 is a known sensitive environment for Box64 emulation. The regression seems to specifically break the 4k-to-16k memory mapping that was working in previous builds.

**Logs (with BOX64_LOG=1):**

```
DEBU[0000] Using /data to match uid and gid
DEBU[0000] Resolved UID=1000 from match path
DEBU[0000] Resolved GID=1000 from match path
Image info: buildtime=2026-02-21T23:16:46.688Z,version=master,revision=9c027c86802d67e4313ec469b6808ce4ad803a37
Looking up latest version...
Updating permissions
Starting Bedrock server...
[BOX64] Dynarec for ARM64, with extension: ASIMD AES CRC32 PMULL ATOMICS SHA1 SHA2
[BOX64] Running on Cortex-A76 with 4 cores, pagesize: 16384
[BOX64] Will use hardware counter measured at 54.0 MHz emulating 3.4 GHz
[BOX64] Detected 48bits at least of address space
[BOX64] Counted 28 Env var
[BOX64] Library search path:
[BOX64] Binary search path: ./:bin/:/usr/local/sbin/:/usr/local/bin/:/usr/sbin/:/usr/bin/:/sbin/:/bin/
[BOX64] Looking for ./bedrock_server-1.26.1.1
[BOX64] 0037|SIGSEGV @0x7fff161b3130 (???(/lib/aarch64-linux-gnu/libc.so.6+0xa3130)) (x64pc=0x30000080/"box64/ExitEmulation", rsp=0x7fff15ef0000, stack=0x7fff15eb0000:0x7fff15ef0000 own=0x7fff15eb0000 fp=(nil)), for accessing 0x10331e2a0 (code=2/prot=5), db=(nil)((nil):(nil)/(nil):(nil)/???:clean, hash:0/0) handler=(nil)
RAX:0x0000000000000000 RCX:0x0000000000000000 RDX:0x0000000000000000 RBX:0x0000000000000000
RSP:0x00007fff15ef0000 RBP:0x0000000000000000 RSI:0x0000000000000000 RDI:0x0000000000000000
R8:0x0000000000000000 R9:0x0000000000000000 R10:0x0000000000000000 R11:0x0000000000000000
R12:0x0000000000000000 R13:0x0000000000000000 R14:0x0000000000000000 R15:0x0000000000000000 ES:0x002b CS:0x0033 SS:0x002b DS:0x002b FS:0x0000 GS:0x0000 FSBASE=0x6661d690 GSBASE=(nil)
2026-02-22T20:05:27.280Z WARN mc-server-runner Minecraft server failed. Inspect logs above for errors that indicate cause. DO NOT report this line as an error. {"exitCode": -1}
2026-02-22T20:05:27.280Z INFO mc-server-runner Done
```

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Compare the image-build changes between tags 2025.12.2 and 2026.2.0, focusing on the Box64 runtime used on a Raspberry Pi 5 with a 16KB page size. Reproduce with VERSION=LATEST and BOX64_LOG=1; done means the Bedrock server starts normally instead of exiting with code -1.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, raspberry-pi, shell
Domain
devops, infrastructure, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.