More Docker. Easy Access. New Streamlined Plans. Learn more.

Nano Server

Verified Publisher

windows/nanoserver

By Microsoft

Updated 9 months ago

The official Nano Server base image for containers

11

Featured Tags

  • ltsc2025 (LTSC) docker pull mcr.microsoft.com/windows/nanoserver:ltsc2025
  • ltsc2022 (LTSC) docker pull mcr.microsoft.com/windows/nanoserver:ltsc2022
  • ltsc2019 (LTSC) docker pull mcr.microsoft.com/windows/nanoserver:ltsc2019

About This Image

This is a base image for Windows Server containers. This image carries the Nano Server base OS image.

For more information about servicing lifecycles, visit Base Image Servicing Lifecycles.

How to Use this Image

Windows requires the host OS version to match the container OS version. If you want to run a container based on a newer Windows build, make sure you have an equivalent host build. Otherwise, you can use Hyper-V isolation to run older containers on new host builds. You can read more on Windows Container Version Compatibility in our Container Docs.

The default entrypoint is for this image is Cmd.exe. To run the image:

docker run mcr.microsoft.com/windows/nanoserver:2025

Note: This repo does not publish or maintain alatesttag. Please declare a specific tag when pulling or referencing images from this repo.

Configuration

  • Your host must have the Windows container feature enabled. The Windows container feature is only available on Windows Server 2016 (Core and with Desktop Experience), Windows 10 Professional and Enterprise (Anniversary Edition) and later.
  • If you intend to run the container with Hyper-V isolation, The Hyper-V role must be installed on the host first.

Related Repos

Full Tag Listing

Windows Images
TagsArchitectureDockerfileOsVersionCreatedTimeLastUpdatedTime
ltsc2025multiarchNo Dockerfile10.0.26100.319411/01/202402/11/2025
ltsc2025-KB5051987multiarchNo Dockerfile10.0.26100.319402/11/202502/11/2025
10.0.26100.3194multiarchNo Dockerfile10.0.26100.319402/11/202502/11/2025
ltsc2025-amd64amd64No Dockerfile10.0.26100.319411/01/202402/11/2025
ltsc2025-KB5051987-amd64amd64No Dockerfile10.0.26100.319402/11/202502/11/2025
10.0.26100.3194-amd64amd64No Dockerfile10.0.26100.319402/11/202502/11/2025
ltsc2022multiarchNo Dockerfile10.0.20348.320708/18/202102/11/2025
ltsc2022-KB5051979multiarchNo Dockerfile10.0.20348.320702/11/202502/11/2025
10.0.20348.3207multiarchNo Dockerfile10.0.20348.320702/11/202502/11/2025
ltsc2022-amd64amd64No Dockerfile10.0.20348.320708/18/202102/11/2025
ltsc2022-KB5051979-amd64amd64No Dockerfile10.0.20348.320702/11/202502/11/2025
10.0.20348.3207-amd64amd64No Dockerfile10.0.20348.320702/11/202502/11/2025
20H2multiarchNo Dockerfile10.0.19042.188911/10/202008/09/2022
20H2-KB5016616multiarchNo Dockerfile10.0.19042.188908/09/202208/09/2022
10.0.19042.1889multiarchNo Dockerfile10.0.19042.188908/09/202208/09/2022
20H2-amd64amd64No Dockerfile10.0.19042.188911/10/202008/09/2022
20H2-KB5016616-amd64amd64No Dockerfile10.0.19042.188908/09/202208/09/2022
10.0.19042.1889-amd64amd64No Dockerfile10.0.19042.188908/09/202208/09/2022
2004multiarchNo Dockerfile10.0.19041.141505/27/202012/14/2021
2004-KB5008212multiarchNo Dockerfile10.0.19041.141512/14/202112/14/2021
10.0.19041.1415multiarchNo Dockerfile10.0.19041.141512/14/202112/14/2021
2004-amd64amd64No Dockerfile10.0.19041.141505/27/202012/14/2021
2004-KB5008212-amd64amd64No Dockerfile10.0.19041.141512/14/202112/14/2021
10.0.19041.1415-amd64amd64No Dockerfile10.0.19041.141512/14/202112/14/2021
1909multiarchNo Dockerfile10.0.18363.155611/12/201905/11/2021
1909-KB5003169multiarchNo Dockerfile10.0.18363.155605/11/202105/11/2021
10.0.18363.1556multiarchNo Dockerfile10.0.18363.155605/11/202105/11/2021
1909-amd64amd64No Dockerfile10.0.18363.155611/12/201905/11/2021
1909-KB5003169amd64No Dockerfile10.0.18363.155605/11/202105/11/2021
10.0.18363.1556-amd64amd64No Dockerfile10.0.18363.155605/11/202105/11/2021
ltsc2019multiarchNo Dockerfile10.0.17763.689308/09/202202/11/2025
1809multiarchNo Dockerfile10.0.17763.689311/13/201802/11/2025
1809-KB5052000multiarchNo Dockerfile10.0.17763.689302/11/202502/11/2025
10.0.17763.6893multiarchNo Dockerfile10.0.17763.689302/11/202502/11/2025
ltsc2019-amd64amd64No Dockerfile10.0.17763.689308/09/202202/11/2025
1809-amd64amd64No Dockerfile10.0.17763.689302/12/201902/11/2025
1809-KB5052000-amd64amd64No Dockerfile10.0.17763.689302/11/202502/11/2025
10.0.17763.6893-amd64amd64No Dockerfile10.0.17763.689302/11/202502/11/2025
Multi-arch Images
TagsAchitectureOSOsVersionCreatedTimeLastUpdated Time
ltsc2025multiarchwindows10.0.26100.319411/01/202402/11/2025
ltsc2025-KB5051987multiarchwindows10.0.26100.319402/11/202502/11/2025
10.0.26100.3194multiarchwindows10.0.26100.319402/11/202502/11/2025
ltsc2022multiarchwindows10.0.20348.320708/18/202102/11/2025
ltsc2022-KB5051979multiarchwindows10.0.20348.320702/11/202502/11/2025
10.0.20348.3207multiarchwindows10.0.20348.320702/11/202502/11/2025
20H2multiarchwindows10.0.19042.188911/10/202008/09/2022
20H2-KB5016616multiarchwindows10.0.19042.188908/09/202208/09/2022
10.0.19042.1889multiarchwindows10.0.19042.188908/09/202208/09/2022
2004multiarchwindows10.0.19041.141505/27/202012/14/2021
2004-KB5008212multiarchwindows10.0.19041.141512/14/202112/14/2021
10.0.19041.1415multiarchwindows10.0.19041.141512/14/202112/14/2021
1909multiarchwindows10.0.18363.155611/12/201905/11/2021
1909-KB5003169amd64, multiarchwindows10.0.18363.155605/11/202105/11/2021
10.0.18363.1556multiarchwindows10.0.18363.155605/11/202105/11/2021
ltsc2019multiarchwindows10.0.17763.689308/09/202202/11/2025
1809multiarchwindows10.0.17763.689311/13/201802/11/2025
1809-KB5052000multiarchwindows10.0.17763.689302/11/202502/11/2025
10.0.17763.6893multiarchwindows10.0.17763.689302/11/202502/11/2025

You can retrieve a list of all available tags for windows/nanoserver at https://mcr.microsoft.com/v2/windows/nanoserver/tags/list

Support

Feedback

License

MICROSOFT SOFTWARE SUPPLEMENTAL LICENSE FOR WINDOWS CONTAINER BASE IMAGE
This Supplemental License is for the Windows Container Base Image (“Container Image”). If you comply with the terms of this Supplemental License you may use the Container Image as described below.

CONTAINER OS IMAGE
The Container Image may only be used with a validly licensed copy of:

  • Windows Server Standard or Windows Server Datacenter software (collectively “Server Host Software”), or
  • Microsoft Windows Operating System (version 10 and 11) software (“Client Host Software”), or
  • Windows 10 and 11 IoT Enterprise and Windows 10 and 11 IoT Core (collectively “IoT Host Software”).

The Server Host Software, Client Host Software, and IoT Host Software are collectively referred to as the “Host Software” and a license for Host Software is a "Host License".

You may not use the Container Image if you do not have a corresponding version and edition of the Host License. Certain restrictions and additional terms may apply, which are described herein. If licensing terms herein conflict with Host License, then this Supplemental License shall govern with respect to the Container Image. BY ACCEPTING THIS SUPPLEMENTAL LICENSE OR USING THE CONTAINER IMAGE, YOU AGREE TO ALL OF THESE TERMS. IF YOU DO NOT ACCEPT AND COMPLY WITH THESE TERMS, YOU MAY NOT USE THE CONTAINER IMAGE.

DEFINITIONS
Windows Server Container (without Hyper-V isolation) is a feature of Microsoft Windows Server software.

Windows Server Container with Hyper-V isolation. Section 2(k) of the Microsoft Windows Server license terms is hereby deleted in its entirety and replaced with the revised terms as shown in “UPDATED” below.

UPDATED: Windows Server Container with Hyper-V isolation (formerly known as Hyper-V Container) is a container technology in Windows Server which utilizes a virtual operating system environment to host one or more Windows Server Container(s). Each Hyper-V isolation instance used to host one or more Windows Server Container(s) is considered one virtual operating system environment.

LICENSE TERMS
Host License. The Host License terms apply to your use of the Container Image and any Windows container(s) created with the Container Image which are distinct and separate from a virtual machine.

Use Rights. The Container Image may be used to create an isolated virtualized Windows operating system environment that includes at least one application that adds primary and significant functionality. You may use the Container Image only to create, build, and run Windows container(s) on Host Software. Updates to the Host Software may not update the Container Image so you may re-create any Windows containers based on an updated Container Image.

Restrictions. You may not remove this Supplemental License document file from the Container Image. You may not enable remote access to the application(s) you run within your container to avoid applicable license fees. You may not reverse engineer, decompile, or disassemble the Container Image, or attempt to do so, except and only to the extent required by third party licensing terms governing the use of certain open-source components that may be included with the software. Additional restrictions in the Host License may apply.

ADDITIONAL TERMS
Client Host Software. When running a Container Image on Client Host Software you may run any number of the Container Image instantiated as Windows containers for test or development purposes only. You may not use these Windows containers in a production environment on Client Host Software.

IoT Host Software. When running a Container Image on IoT Host Software you may run any number of the Container Image instantiated as Windows containers for test or development purposes only. You may only use the Container Image in a production environment if you have agreed to the Microsoft Commercial Terms of Use for Windows 10 Core Runtime Images or the Windows 10 IoT Enterprise Device License (“Windows IoT Commercial Agreement”). Additional terms and restrictions in the Windows IoT Commercial Agreements apply to your use of Container Image in a production environment.

Third Party Software. The Container Image may include third party applications that are licensed to you under this Supplemental License or under their own terms. License terms, notices, and acknowledgements, if any, for the third-party applications may be accessible online at http://aka.ms/thirdpartynotices or in an accompanying notices file. Even if such applications are governed by other agreements, the disclaimer, limitations on, and exclusions of damages in the Host License also apply to the extent allowed by applicable law.

Open Source Components. The Container Image may contain third party copyrighted software licensed under open source licenses with source code availability obligations. Copies of those licenses are included in the ThirdPartyNotices file or other accompanying notices file. You may obtain the complete corresponding source code from Microsoft if and as required under the relevant open source license by sending a money order or check for $5.00 to: Source Code Compliance Team, Microsoft Corporation, 1 Microsoft Way, Redmond, WA 98052, USA. Please include the name “Microsoft Software Supplemental License for Windows Container base image,“ the open source component name and version number in the memo line of your payment. You may also find a copy of the source at http://aka.ms/getsource.

Docker Pull Command

docker pull mcr.microsoft.com/windows/nanoserver