event-handler docker image for linux/arm64

[limcheekin]

Description

Hi there,

When I run the docker compose up -d command, it reported the following error:
! event-handler The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested 0.0s

Appreciate if you could publish the docker image for linux/arm64 platform.

Thanks.

Use Case

It will help to run thepopebot in a Single-Board Computer (SBC) such as Raspberry Pi, Orange Pi, etc.

[fridayfairvilla]

This error also occurs when running on MacOS. You can force Docker to use the AMD64 version with Rosetta by adding "platform: linux/amd64" to the docker-config.yml file. Place it after the image: line in the event handler: section as below:
event-handler:
container_name: thepopebot-event-handler
image: ${EVENT_HANDLER_IMAGE_URL:-stephengpope/thepopebot:event-handler-${THEPOPEBOT_VERSION:-latest}}
platform: linux/amd64
volumes:

[limcheekin]

Thanks for quick response.

The workaround doesn't seems working. The container started successfully, but it keep restarting according to the docker compose ps:

NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS 
thepopebot-event-handler stephengpope/thepopebot:event-handler-1.2.70 "docker-entrypoint.s…" event-handler 23 minutes ago Restarting (255) 33 seconds ago

The command docker logs thepopebot-event-handler --tail 1 return the following error:

exec /usr/local/bin/docker-entrypoint.sh: exec format error

Lastly, the following commands with the following console output:

docker compose stop event-handler
docker compose up --no-deps --force-recreate --build event-handler

console output:

[+] stop 1/1
 ✔ Container thepopebot-event-handler Stopped                                                                                              0.0s 
WARN[0000] No services to build                         
[+] up 1/1
 ✔ Container thepopebot-event-handler Recreated                                                                                            0.1s 
Attaching to thepopebot-event-handler
thepopebot-event-handler  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
thepopebot-event-handler exited with code 255 (restarting)
thepopebot-event-handler exited with code 255 (restarting)
thepopebot-event-handler  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
thepopebot-event-handler  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
thepopebot-event-handler  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
thepopebot-event-handler exited with code 255 (restarting)
thepopebot-event-handler  | exec /usr/local/bin/docker-entrypoint.sh: exec format error
thepopebot-event-handler exited with code 255 (restarting)

Please advise. Thank you.

[renjith100]

The platform: linux/amd64 fix alone is not enough — you also need QEMU binfmt support installed so Docker can emulate amd64 binaries on ARM64.

Step 1: Install QEMU emulation (one-time setup):

docker run --privileged --rm tonistiigi/binfmt --install all
Step 2: Add platform: linux/amd64 to the event-handler service in docker-compose.yml:

event-handler:
container_name: thepopebot-event-handler
platform: linux/amd64
image: ${EVENT_HANDLER_IMAGE_URL:-stephengpope/thepopebot:event-handler-${THEPOPEBOT_VERSION:-latest}}
Step 3: Restart the containers:

docker compose down
docker compose up -d
The exec format error occurs because without QEMU, the ARM64 host cannot execute the amd64 entrypoint binary. The tonistiigi/binfmt command registers the necessary binfmt_misc kernel handlers so Docker can transparently run amd64 containers via QEMU on ARM64 hardware (Raspberry Pi, Orange Pi, Oracle Cloud ARM instances, etc.).

The long-term fix would be for the maintainer to publish a multi-arch image (linux/arm64) so emulation isn't needed at all.

Disclosure: Created with Claude

[limcheekin]

The platform: linux/amd64 fix alone is not enough — you also need QEMU binfmt support installed so Docker can emulate amd64 binaries on ARM64.

Step 1: Install QEMU emulation (one-time setup):

docker run --privileged --rm tonistiigi/binfmt --install all Step 2: Add platform: linux/amd64 to the event-handler service in docker-compose.yml:

event-handler: container_name: thepopebot-event-handler platform: linux/amd64 image: ${EVENT_HANDLER_IMAGE_URL:-stephengpope/thepopebot:event-handler-${THEPOPEBOT_VERSION:-latest}} Step 3: Restart the containers:

docker compose down docker compose up -d The exec format error occurs because without QEMU, the ARM64 host cannot execute the amd64 entrypoint binary. The tonistiigi/binfmt command registers the necessary binfmt_misc kernel handlers so Docker can transparently run amd64 containers via QEMU on ARM64 hardware (Raspberry Pi, Orange Pi, Oracle Cloud ARM instances, etc.).

The long-term fix would be for the maintainer to publish a multi-arch image (linux/arm64) so emulation isn't needed at all.

Disclosure: Created with Claude

Thanks for sharing the workaround solution.

At least I can keep things moving now.

[stephengpope]

ARM64 support is already in place — the event-handler image (and all coding agent images) are built and published as multi-arch (linux/amd64,linux/arm64) via docker buildx in the publish workflow. You can pull and run on ARM64 with the latest version. Let us know if you hit any issues!