Skip to content

Update Docker Compose Apple Silicon guidance#363

Merged
sevein merged 1 commit into
2.10from
dev/arm64-update
May 13, 2026
Merged

Update Docker Compose Apple Silicon guidance#363
sevein merged 1 commit into
2.10from
dev/arm64-update

Conversation

@sevein

@sevein sevein commented May 12, 2026

Copy link
Copy Markdown
Member

The AtoM development service images now publish ARM64 variants, so Apple Silicon and other ARM-based hosts can use the default Compose file without an additional platform override.

Discourage platform: linux/amd64 for everyday ARM development because it forces emulation instead of using native ARM64 images.

Image variant checks:

docker buildx imagetools inspect docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.2
docker buildx imagetools inspect percona/percona-server:8.4

When you stop using docker-compose.override.arm.yml you may see the following error because Docker could be using locally cached linux/amd64 images for those tags:

! elasticsearch                    The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested
! percona                          The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested

To reset them to native ARM64:

docker compose -f docker/docker-compose.dev.yml down
docker image rm docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.2
docker image rm percona/percona-server:8.4
docker compose -f docker/docker-compose.dev.yml up -d

CC @yenaing-oo

The AtoM development service images now publish ARM64 variants, so Apple
Silicon and other ARM-based hosts can use the default Compose file without
an additional platform override.

Discourage `platform: linux/amd64` for everyday ARM development because it
forces emulation instead of using native ARM64 images.

Image variant checks:

  docker buildx imagetools inspect docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.2
  docker buildx imagetools inspect percona/percona-server:8.4
@sevein sevein requested review from anvit, melaniekung and sbreker May 12, 2026 08:27

@melaniekung melaniekung left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks @sevein !

@sevein sevein merged commit 58acd8f into 2.10 May 13, 2026
2 checks passed
@sevein sevein deleted the dev/arm64-update branch May 13, 2026 02:02
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.

2 participants