Skip to content

fix(release): pin agent-core to linux/amd64 for arm64 install (v0.5.1) - #187

Merged
waylandzhang merged 1 commit into
mainfrom
release/v0.5.1
Jun 2, 2026
Merged

fix(release): pin agent-core to linux/amd64 for arm64 install (v0.5.1)#187
waylandzhang merged 1 commit into
mainfrom
release/v0.5.1

Conversation

@waylandzhang

Copy link
Copy Markdown
Collaborator

Summary

Hotfix for v0.5.1: the one-command installer fails on Apple Silicon / arm64 hosts.

Problem

docker compose pull errors with:

agent-core: no matching manifest for linux/arm64/v8 ... not found

release.yml builds agent-core amd64-only (Rust + QEMU arm64 build is too slow in CI); the other 4 images are multi-arch. The release compose did not pin a platform, so arm64 hosts requested a nonexistent arm64 manifest and the install died at pull. Pre-existing since v0.4.0 — surfaced during the v0.5.0 install smoke.

Fix

Pin agent-core to platform: linux/amd64 in docker-compose.release.yml. arm64 hosts pull the amd64 image and run it under Docker Desktop emulation.

Verification (on Apple Silicon / arm64)

  • Reproduced the failure with the published v0.5.0 release compose.
  • Confirmed agent-core:v0.5.0 has an amd64 manifest (no arm64); docker pull --platform linux/amd64 + run works (uname -m = x86_64 inside).
  • With the pin, the full published-image stack comes up healthy (8/8 containers); gateway /health and /api/v1/tools (14 tools) green.

Changes

  • deploy/compose/docker-compose.release.yml — pin agent-core platform: linux/amd64; bump example header to v0.5.1
  • scripts/install.sh — default SHANNON_VERSION v0.5.0 → v0.5.1
  • CHANGELOG.md[0.5.1] section

After merge (separate, explicit)

Tag v0.5.1 on merged mainrelease.yml rebuilds/pushes images + latest, cuts the GitHub release. Because install.sh pulls the compose from the version tag, the fix only reaches users via this new tag.

The one-command installer failed on Apple Silicon / arm64 hosts at the
agent-core pull: agent-core is published amd64-only (Rust + QEMU arm64
build is too slow in CI), the other 4 images are multi-arch, and the
release compose did not pin a platform — so arm64 hosts requested a
nonexistent linux/arm64 manifest and the install died.

Pin agent-core to platform: linux/amd64 so arm64 hosts pull the amd64
image and run it under emulation (verified: full stack healthy on arm64).

Pre-existing since v0.4.0; surfaced during the v0.5.0 install smoke.

- docker-compose.release.yml: pin agent-core platform + bump example header
- install.sh: default SHANNON_VERSION v0.5.0 -> v0.5.1
- CHANGELOG: add [0.5.1] section
@waylandzhang
waylandzhang merged commit 0190a84 into main Jun 2, 2026
4 checks passed
@waylandzhang
waylandzhang deleted the release/v0.5.1 branch June 2, 2026 13:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant