Skip to content

TechDirectArchive

Hands-on IT, Cloud, Security, Veeam & DevOps

  • Home
  • About
  • Advertise With US
  • Reviews
  • Contact
  • Toggle search form

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

Posted on 16/10/202128/08/2026 Christian By Christian 2 Comments on 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
  1. Home
  2. Network | Monitoring
  3. 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 images

In this article, we shall discuss how to resolve “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”. 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, and Azure DevOps and GitHub integration for Docker and Kubernetes deployment.

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). 

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.

Windows platform

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

C:\GitLab-Runner>docker run mcr.microsoft.com/windows/servercore:20H2-amd64
Unable to find image 'mcr.microsoft.com/windows/servercore:20H2-amd64' 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'.

Also, see how to create a static pod in Kubernetes. And how to install, register and start GitLab Runner on Windows.

Solution

Switch to Windows Container to resolve Docker image OS “Windows” cannot be used on this platform

To address the Docker Image Compatibility Issue with OS ‘Windows’, consider transitioning from Linux containers. Moreover, For Windows containers, as illustrated in the accompanying screenshot.-

Click on the Show hidden icons and right-click on the Docker icon as shown below. Click on Switch to Windows Container.

Linux

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

Screenshot-2021-10-16-at-22.56.57

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

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

Furthermore, Once you address the Docker Image Compatibility Issue with OS ‘Windows’, running Docker again will yield successful results.

Captur3e

I hope you found this article useful on “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’. Please feel free to leave a comment below.

Thank you for reading this post. Kindly share it with others.

  • Share on X (Opens in new window) X
  • Share on Reddit (Opens in new window) Reddit
  • Share on LinkedIn (Opens in new window) LinkedIn
  • Share on Facebook (Opens in new window) Facebook
  • Share on Pinterest (Opens in new window) Pinterest
  • Share on Tumblr (Opens in new window) Tumblr
  • Share on Telegram (Opens in new window) Telegram
  • Share on WhatsApp (Opens in new window) WhatsApp
  • Share on Mastodon (Opens in new window) Mastodon
  • Share on Bluesky (Opens in new window) Bluesky
Network | Monitoring Tags:docker, docker cli, Windows 10

Post navigation

Previous Post: How to uninstall GitLab Runner from your Windows device
Next Post: The executor requires OSType=windows, but Docker Engine supports only OSType=linux

Related Posts

  • Fix Windows Security Blank Screen Issue
    How to Fix Windows Security Blank Screen Issue Network | Monitoring
  • Exchange Admin Centre EMC
    How to grant Access to User Mailbox Network | Monitoring
  • Preliminary Active Directory Analysis
    Preliminary Guide for Active Directory and Initial Assessment Network | Monitoring
  • image 29
    How to force your website to redirect from HTTP to HTTPS using a web.config file Network | Monitoring
  • image 9
    Fix Error 853: The remote access connection completed, but authentication failed because the certificate that authenticates the client to the server is not valid Network | Monitoring
  • SSU
    What to know about the servicing stack update and latest cumulative update in Windows Network | Monitoring

More Related Articles

980239e9 cisco logo Security Best Practice to secure your Cisco Router and Switches Network | Monitoring
troubleshooting Active Directory Replication How to troubleshoot Active Directory Replication issues Network | Monitoring
Allow and Disallow Simultaneous Connection to Domain and Non Domain network Allow and Disallow Simultaneous Connection to Domain and Non-Domain network Network | Monitoring
banner How to Check and Reset Network Data Usage in Windows 11 Network | Monitoring
screenshot 2020 04 07 at 02.14.53 SSH and Telnet on Cisco ASA 5505: Quick Setup Guide Network | Monitoring
TZ TFTP Image to Flash: Copying Guide for Cisco ASA Network | Monitoring

Comments (2) on “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”

  1. Avatar photo Juan Vilar says:
    20/04/2022 at 10:03 AM

    this will not work in windows home edition.

    Log in to Reply
    1. chris Christian says:
      20/04/2022 at 10:43 AM

      This was tested on Windows 10 Professional and Enterprise Edition

      Log in to Reply

Leave a Reply Cancel reply

You must be logged in to post a comment.

Microsoft MVP

vexpert-badge-stars-5

Virtual Background

VEEAMLEGEND

Categories

Top 30 Sysadmin blog

veeaam100

Veeam Vanguard

  • Microaoft Edge
    Bing AI-Powered Copilot: How to install Microsoft Edge on macOS Network | Monitoring
  • windows 10 keyboard shortcut 1024x512 1
    How to create a Desktop shortcut in Windows Windows
  • images 1 1
    How To Use Pleasant Password Private Folder Password Manager
  • How to install and configure a Standalone DNS Server
    How to Install and Configure a Standalone DNS Server Windows Server
  • drivelock 1
    How to activate DriveLock License on Windows Server Windows Server
  • Allow and Disallow Simultaneous Connection to Domain and Non Domain network
    Allow and Disallow Simultaneous Connection to Domain and Non-Domain network Network | Monitoring
  • docker desktop 1
    Failed to remove network for build: Error during connect in the default daemon configuration on Windows, the Docker client must be run with elevated privileges Containers
  • Banner 1 e1781003668538
    How to Assign a Public IP to Azure Virtual Machine (VM) AWS/Azure/OpenShift

Subscribe to Blog via Email

Enter your email address to subscribe to this blog and receive notifications of new posts by email.

Join 1,747 other subscribers
  • RSS - Posts
  • RSS - Comments
  • About
  • Authors
  • Write for us
  • Contact
  • Advertise with us
  • General Terms and Conditions
  • Privacy policy
  • Feedly
  • Telegram
  • Youtube
  • Facebook
  • Instagram
  • LinkedIn
  • Tumblr
  • Pinterest
  • Twitter
  • mastodon
  • Bsky

Tags

Active Directory Azure Bitlocker Microsoft Windows PowerShell WDS Windows 10 Windows 11 Windows Deployment Services Windows Server 2016

Copyright © 2026 TechDirectArchive

Loading Comments...

You must be logged in to post a comment.