Scott Hanselman

Getting Started with .NET Core and Docker and the Microsoft Container Registry

March 22, 2019 Comment on this post [7] Posted in Docker | DotNetCore
Sponsored By

It's super easy to get started with .NET Core and/or ASP.NET Core with Docker. If you have Docker installed you don't need to install anything to try out .NET Core, of course.

To run a little .NET Core console app:

docker run --rm

And the result:

latest: Pulling from dotnet/core/samples
Hello from .NET Core!

Platform: .NET Core
OS: Linux 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018

To run a quick little ASP.NET Core website just:

docker run -it --rm -p 8000:80 --name aspnetcore_sample

And here it is running on localhost:8000

Simple ASP.NET Core app under Docker

You can also host ASP.NET Core Images with Docker over HTTPS to with this image, or run ASP.NET Core apps in Windows Containers.

Note that Microsoft teams are now publishing container images to the MCR (Microsoft Container Registry) so they can use the Azure CDN and pull faster when they are closer to you globally. The images start at MCR and then can be syndicated to other container registries.

The new repos follow:

When you "docker pull" you can use tag strings for .NET Core and it works across any supported .NET Core version

  • SDK: docker pull
  • ASP.NET Core Runtime: docker pull
  • .NET Core Runtime: docker pull
  • .NET Core Runtime Dependencies: docker pull

For example, I can run the .NET Core 3.0 SDK and mess around with it like this:

docker run -it 

I've been using Docker to run my unit tests on my podcast site within a container locally. Then I volume mount and dump the test results out in a local folder and inspect them with Visual Studio

docker build --pull --target testrunner -t podcast:test .
docker run --rm -v c:\github\hanselminutes-core\TestResults:/app/hanselminutes.core.tests/TestResults podcast:test

I can then either host the Docker container in Azure App Service for Containers, or as little one-off per-second billed instances with Azure Container Instances (ACI).

Have you been using .NET Core in Docker? How has it been going for you?

Sponsor: Manage GitHub Pull Requests right from the IDE with the latest JetBrains Rider. An integrated performance profiler on Windows comes to the rescue as well.

About Scott

Scott Hanselman is a former professor, former Chief Architect in finance, now speaker, consultant, father, diabetic, and Microsoft employee. He is a failed stand-up comic, a cornrower, and a book author.

facebook twitter subscribe
About   Newsletter
Hosting By
Hosted in an Azure App Service
March 25, 2019 8:29
We're using Azure Kubernetes to host Docker containers with .NET Core 2.1 apps (backend and frontend), it's great to scale easily.

Also, we use .NET Core within Docker in the DevOps C.I. (builds) to run no-traditional tests, like execution of the app.
March 25, 2019 12:41
Hosting using Docker is fine. The problem why it's fairly difficult to start using it professionally (everything should be hosted on-premise) is because there are no official Docker Registry images running on Windows and for someone how never used Unix systems it becomes a hurdle.

Additionally building with Docker is still untamed beast for me as I explained in my StackOverflow post:

Also this issue:

I wish I could build and deploy using Docker images but for now it looks like Docker for Windows is still not there =(
March 25, 2019 13:06
We're run full Windows Container in the company(intranet), not easy work.
March 25, 2019 13:28
Is there some way to find out what ISNT supported in Windows docker images?

(My personal gripe: Windows Media Foundation - want to transcode video? Not in docker!)

I’ve been unable to find any real information about the differences between a docker Windows image and a real OS install.

It kind of undermines the value of containers if they’re not *exactly* the same as the true OS.
March 25, 2019 22:14
Could somebody tell which version of Windows is required to run Windows Docker images in production?

If I am reading the licensing correctly, it is Windows Server Datacenter edition. Am I wrong?

Thank you.
March 26, 2019 12:44
I am doing a presentation about Docker for Devs. See my work at
If you have some suggestions, I will be happy to incorporate !
March 26, 2019 15:53
Ignat Andrei, check this
Simple docker-compose example of stateful microservice (your own selfhosted private registry) published to internet using automated LetsEncrypt.

To create ./htpasswd file use
docker run  --rm --entrypoint htpasswd registry:2 -Bbn mylogin mypassword  > ~/.htpasswd


version: '2'
image: registry:2
restart: always
enabled: false
enabled: false
- "/var/lib/registry"
- ~/.htpasswd:/auth_htpasswd
- "~/registry:/var/lib/registry"
image: jwilder/nginx-proxy
restart: always
- "80:80"
- "443:443"
- "/etc/nginx/vhost.d"
- "/usr/share/nginx/html"
- "/var/run/docker.sock:/tmp/docker.sock:ro"
- "/etc/nginx/certs"
- "./my_custom_proxy_settings.conf:/etc/nginx/conf.d/my_custom_proxy_settings.conf"
image: jrcs/letsencrypt-nginx-proxy-companion
restart: always
- "/var/run/docker.sock:/var/run/docker.sock:ro"
- "nginx-proxy"

This is example. This is not deeply-tested production-ready solution. Nginx need some tuning to be good reverse proxy for production usage.
I am using similar config as ingress in k8s with edited nginx buffers.

Comments are closed.

Disclaimer: The opinions expressed herein are my own personal opinions and do not represent my employer's view in any way.