Docker image OS”windows” cannot be used on this platform: No matching manifest for linux/amd64 in the manifest list entries from Microsoft Docker Registry


Docker is an open-source containerization platform that enables developers to package apps into containers and standardized executable components combining application source code with the operating system (OS) libraries and dependencies required to run that code in any environment. The Docker Engine and client aren’t included with Windows and need to be installed and configured individually. You need Docker in order to work with Windows Containers. Docker consists of the Docker Engine (dockerd.exe), and the Docker client (docker.exe). Kindly refer to these related guides: How to create and deploy a local Registry Server with Docker Image, how to Pull your first Nginx Container Image from Docker Hub and deploy it to your local machine, Azure DevOps and GitHub integration for Docker and Kubernetes deployment, how to create a static pod in Kubernetes, and how to install, register and start GitLab Runner on Windows.

The below error occurs when you are trying to pull Microsoft Container images from Microsoft Container Registry (MCR). The error is usually due to a lot of reasons and there are many solutions to it. I will be discussing the fix that worked for me in this troubleshooting guide.

You may also get the following error, do not freight, all you need do is to switch to Windows container as discussed below.

C:\GitLab-Runner>docker run
Unable to find image '' locally
20H2-amd64: Pulling from windows/servercore
18ae6bebe21d: Pulling fs layer
df018de09299: Pulling fs layer
docker: image operating system "windows" cannot be used on this platform.
See 'docker run --help'.

Solution: Switch to Windows Container

Instead of running on Linux containers, you need to switch to Windows containers as shown in the screenshot below.
– Click on the Show hidden icons and right-click on the Docker icon as shown below.
– Click on Switch to Windows Container.


Alternatively, you may have to SwitchDaemon the configuration via Command Prompt or PowerShell as shown below.


You can use the following command on PowerShell as shown below.

PS C:\Program Files\Docker\Docker> ./DockerCli.exe -SwitchDaemon

When these are done, and you try to run Docker again, it will be successful.


Regardless of the steps you take, this issue will be resolved. I hope you found this blog post helpful. If you have any questions, please let me know in the comment session.

Notify of

Inline Feedbacks
View all comments
Juan Vilar
1 year ago

this will not work in windows home edition.

Would love your thoughts, please comment.x