Skip to content

Support linux/amd64 image emulation on Apple Silicon Macs in Docker Swarm #851

@landsman

Description

@landsman

When trying to deploy Docker Swarm services using amd64 images on an Apple Silicon Mac, the deployment fails with the error message:

no suitable node (unsupported platform on 1 node)

This happens despite Docker Desktop supporting amd64 container emulation in standalone mode (docker run --platform linux/amd64).

Steps to reproduce

  1. Use Apple Silicon Mac with Docker Desktop.
  2. Try to deploy a Docker Swarm stack or service with an amd64-only image.
  3. Observe the failure with “no suitable node” error.

Expected behavior
Docker Swarm should support running linux/amd64 containers on ARM Mac hosts using emulation, similar to standalone Docker commands.

Actual behavior
Docker Swarm rejects the deployment due to architecture mismatch and lack of amd64 emulation support in swarm mode.

Additional context

  • Docker Desktop itself can run amd64 images by virtualizing an x86_64 environment.
  • This limitation significantly reduces multi-arch development and testing capabilities on Apple Silicon.
  • This is a blocking issue for users relying on Swarm on ARM Macs with amd64 images.

Metadata

Metadata

Assignees

Labels

community_newNew idea raised by a community contributor

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions