How to get started with IIS on Docker

How To Jun 17, 2020

In one of our customer projects, we have a mixed Swarm Cluster with Linux and Windows nodes. On the Windows nodes, we run a bunch of IIS containers that run several web applications. In this blog post, I want to showcase you how easy it is to deploy a Website on IIS in a Docker Container.

The Internet Information Services (IIS) is a web server for Windows Server. You can find more information about it on the official Web Site. Microsoft already provides a large list of Docker Images for IIS. You can find more information on Docker Hub and the Dockerfiles for the images in the GitHub Repo.

The Code

A web server allows you to access files from a folder via HTTP requests. For IIS the default folder is C:\inetpub\wwwroot. This means, that you need to add the content of your website to this folder. The screenshot below shows an example folder structure. There you can see that all the content of the website is in the wwwroot-folder.

IIS Website folder structure
IIS Website folder structure

Besides the content of your website, all you need is a Dockerfile with only two lines of code:


ADD wwwroot /inetpub/wwwroot/

With the Dockerfile in place, open this folder in PowerShell. To build the container image, execute the following command:

docker build -t iis-website .

After building the image, you can run the container:

docker run -p 80:80 iis-website

Now you can access the website in your favorite browser with the URL http://localhost. Be aware, that it can take several seconds for Windows Containers to start. This means you have to wait a bit until the website appears in your browser.

Screenshot of the Website running on IIS in a Docker Container
Screenshot of the Website running on IIS in a Docker Container

You can extend this approach, to also add all the required configurations to the Dockerfile. This allows you to track all the changes in your version control system. This enables you to add the building, testing, and deployment to your CI/CD pipeline.


In this post, I showed how easy it is to run a website on IIS in a Docker container. By specifying everything in code you can add the configurations and all the needed files to your version control system. This enables you to integrate it into a CI/CD pipeline, one piece of the DevOps puzzle.

In the meantime, I have recorded a video that also explains the needed steps.

As a bonus, it is also available in German.

More Information

I didn't cover how to get started with Docker on Windows in this post. You can find more information about that in the official documentation:

For more information about IIS on Docker, you can head over to the following links:

Find out more about 56K.Cloud

We love Cloud, IoT, Containers, DevOps, and Infrastructure as Code. If you are interested in chatting connect with us on Twitter or drop us an email: info@56K.Cloud. We hope you found this article helpful. If there is anything you would like to contribute or you have questions, please let us know!


Jochen Zehnder

Site Reliability Engineer

Great! You've successfully subscribed.
Great! Next, complete checkout for full access.
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.