How to run an asp net core application in docker container


Running an ASP.NET Core application in a Docker container provides several benefits, including portability, scalability, and ease of deployment. In this article, we will explore how to run an ASP.NET Core application in a Docker container, step by step.


Before we begin, make sure you have the following prerequisites:

  • ASP.NET Core SDK
  • Docker installed and running

Step 1: Create an ASP.NET Core Application

First, let's create a new ASP.NET Core application. Open your favorite command-line interface and run the following command:

dotnet new web -n MyAspNetApp

This command creates a new ASP.NET Core web application “MyAspNetApp”.

Step 2: Build the Application

Next, to the application's root and build the application the following command:

cd MyAspNetApp
dotnet build

This command compiles the application and generates the necessary binaries.

Step 3: Create a Dockerfile

To run the ASP.NET Core application in a Docker container, we need to create a Dockerfile. Create a new file named “Dockerfile” in the application's root directory and add the following :

FROM AS build-env

COPY . ./
RUN dotnet publish -c Release -o out

COPY --from=build-env /app/out .

ENTRYPOINT ["dotnet", "MyAspNetApp.dll"]

This Dockerfile defines two stages: “build-env” and the final runtime stage. In the “build-env” stage, we copy the application , build the application using the dotnet publish command, and the necessary binaries. In the final stage, we copy the published output from the “build-env” stage and set the to run the application.

Step 4: Build the Docker Image

Now, let's build the Docker image using the Dockerfile. Open your command-line interface and navigate to the application's root directory. Run the following command:

docker build -t myaspnetapp .

This command builds the Docker image with the tag “myaspnetapp”. The dot (.) at the end of the command specifies the build context as the current directory.

Step 5: Run the Docker Container

Finally, let's run the Docker container with the ASP.NET Core application. Run the following command:

docker run -d -p 8080:80 myaspnetapp

This command runs the Docker container in detached mode (-d), maps port 8080 on the host to port 80 in the container (-p 8080:80), and uses the “myaspnetapp” image.


In this article, we have learned how to run an ASP.NET Core application in a Docker container. By following the step-by-step guide, you can easily containerize your ASP.NET Core applications and enjoy the benefits of Docker's portability and scalability.

Rate this post

Leave a Reply

Your email address will not be published. Required fields are marked *

Table of Contents