Here is some details about the Dockerfile commands and runtime from Heroku documentation. Few important points, which is required compared to dockerfile used in ASP.NET Core are.

• The web process must listen for HTTP traffic on $PORT, which is set by Heroku. EXPOSE in Dockerfile is not respected, but can be used for local testing.
• CMD is required. If CMD is missing, the registry will return an error.

For deployment you require two prerequisites.

• Heroku Command Line Interface
• Docker

First you build the project, then you need to create the Docker image, and finally you need to publish the image to Heroku. I have created a MVC project using dotnet new  command.

Once you created the project, you can build it using dotnet publish  command.

dotnet publish -c Release

So your project will be compiled and output will be generated in the bin\Release\netcoreapp1.1\publish  folder.

To deploy to Heroku, first you need to login to the container registry using heroku container:login  command, once you login, you can build a docker image.

docker build -t helloworld-aspnetcore ./bin/Release/netcoreapp1.1/publish

Here is the Dockerfile we are using.

FROM microsoft/dotnet:1.1.0-runtime



WORKDIR /app 

COPY . .



CMD ASPNETCORE_URLS=http://*:$PORT dotnet helloworld-aspnetcore.dll

Since we are running the already published application, my base image is dotnet runtime. And we are using ASPNETCORE_URLS environment variable to bind the $PORT value from Heroku to Kestrel. Initialy we tried using the command line options but it was not working. And you need to copy the Dockerfile to the publish folder,otherwise the command will fail.

Once you build the container, you need to tag it and push it according to this naming template. Here is the commands.

docker tag helloworld-aspnetcore registry.heroku.com/helloworld-aspnetcore/web

In this helloworld-aspnetcore is my app name. You can create apps either using the Web dashboard or using Heroku CLI – heroku create  is the command to create an app using CLI. Once you tag it, you need to push the image to Heroku registry, here is the command.

docker push registry.heroku.com/helloworld-aspnetcore/web

This might take some time depends on the image size and your network bandwidth. Since we already hosted, we are pushing the Web application only.

Now you can browse the app using https://helloworld-aspnetcore.herokuapp.com/ url, if deployment was successful and Kestrel started, you will see an ASP.NET MVC Home Page. If you are viewing an application error page, you need to look into the logs from Heroku.

Also make sure you’re running a dynos in Heroku, otherwise your app won’t work. You can create and use it from Resources menu.