itzg / itzg/docker-minecraft-bedrock-server
Exit Code -1 on Raspberry Pi 5 - Regression in recent image build
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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