ASP.NET Core App With Docker Support

Here, I am going to explain how to run an ASP.NET Core application with the help of Docker.


  • Microsoft Visual Studio professional 2017.
  • Docker community edition 18.03.1
  • Windows 10 Enterprise 64-bit operating system.

I have accomplished this task with the help of this software.

Create ASP.NET CORE application

Open VS2017, then go to File->New->Project->Select ASP.NET Core web application and click on OK button, as shown in the below image.


As soon as you select OK button, it will display the below screen. Select Empty Template and check the Enable Docker support checkbox as well as select OS as Windows and click on the OK button, as shown in the below image.


As soon as we click on the ok button we will get to see some Dockerfile, Program.cs, and Starup.cs files under Solution Explorer. All of these files get added automatically.


So far we have created the application with the help of VS 2017. Now we can see the actual beauty of Docker. Generally, after creating an application in Visual Studio, the next step is to build the app and run it.

Docker is not like that. If you observe in solution explorer, we have Dockerfile where things will happen.

Let’s look into the contents of Dockerfile.


First Line FROM Microsoft/aspnetcore:2.0 is the base image for this application in order to run the dot net core application.

ARG source is the argument which helps to pass data to the image.

WORKDIR /app is the working directory of the image; it will store all DLLs inside the app folder.

COPY will copy the DLLs of the application to the root directory (here dot represents root) of the image.

ENTRYPOINT is responsible to run the main application with the help of ASPNETCOREAPP.dll.

Before running the application we have to build and call the publish command.

Open the command prompt & go to project folder where you have created the project. In my case path is c:/users/projects/ASPNETCOREAPP/

Once you are in the specified path execute the below command:

dotnet publish --configuration Release  --output ./obj/Docker/publish

Once you are done, you can observe inside obj/Docker folder, the publish folder gets created. This publish folder has all DLLs of your project.

Now once again go to command prompt and try to build an image for your application with the help of Docker.

  • Before building the image make sure you have to switch to Windows container; only then can you build images on Docker because while creating dot net core application we have chosen Docker to support OS as Windows.
  • Go to your project folder where Dockerfile exists in command prompt and call the below command

    docker build -t myapp:latest .

  • Here build is docker command to create images
  • -t is the tag (name) of the application
  • Here image name is myapp:latest
  • . (dot) represents current directory where Dockerfile exists.
  • After building the image, you have to run the image with the help of the below command

    docker run -p 5000:5000 myapp:latest

  • Where run is the docker command to run image
  • -p is the port assigned to the application
  • Myapp:latest is the image name
  • Once you run it you can check whether the container is running or not with the help of the below command.

    docker ps –a it will display the list of running containers.

    ASP.NET Core

  • Basically, Windows container will run on a specific IP address. To get the IP address of running container we have to execute the below command.

    docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' cb015e972100(Container ID)

  • It will return the IP address; in my case, it is running on this IP
  • Just go to the browser and call it like below.

    ASP.NET Core