Error AtlasError Documentation and Resolution
Back to searchMore Docker errors

Docker

Docker Desktop reported an incompatible CPU on macOS

Incompatible CPU detected

Docker Desktop determined that the Mac does not provide the required virtualization support or that the wrong architecture build of Docker Desktop was installed.

Incompatible CPU detectedinstallation

Observed message

Incompatible CPU detected

Why it happens

  • The wrong Docker Desktop build was installed for the system architecture.
  • The Mac does not support the Apple Hypervisor framework required by Docker Desktop.

How to fix it

  1. Install the Docker Desktop build that matches the Mac architecture.
  2. Verify hypervisor support with sysctl kern.hv_support.
  3. Review Docker Desktop system requirements for the current Mac model.

Official reference

Docker Docs: Common topics - Incompatible CPU detected

Related errors

Docker.app is damaged and can't be openedDocker Desktop on macOS reported Docker.app is damagedfailed to register layerDocker failed to register layer because lchown returned invalid argumentfailed to register layerDocker failed to register layer because lchown returned operation not permittedfailed to solveDocker build failed to solve

Explore more

DockerBrowse more Docker errorsinstallationBrowse more installation errors
Docker Desktop Incompatible CPU detected: causes and fixes | Error Atlas