Deploy Golang App to Heroku

January 07, 2022 Kehinde Olawuwo 2 minutes

This is a step-by-step tutorial on how to deploy a Golang app on Heroku Server.

It is short, simple and straightforward.


  • Heroku Account
  • Heroku CLI
  • Golang v1.14 and above

Step 1 - Install Heroku CLI.

Create a Heroku account using your email and password or log in if you already have an account.

Download the Heroku CLI by running the command below on macOS or you can also download depending on your operating system

$ brew tap heroku/brew && brew install heroku

Login to Heroku from your terminal using the command

$ heroku login

This will open your web browser to complete the login process.

Step 2 - Create Procfile.

Create Procfile on your Go project root folder by running the command

$ touch Procfile

or just create it from project directory.

Run echo “web: [directory]” > Procfile replace [directory] e.g.

$ echo “web: currency” > Procfile

Step 3 - Set up Go Modules.

Generate a go.mod file using go mod init[user_name]/[project_name] e.g.

$ go mod init

Step 4 - Set Environment Variable.

Set variable names in .env file e.g. PORT=8080 using

$ heroku config:set PORT=8080

You can also set other variables using this command.

Step 5 - Commit Code.

Commit your code using the following commands

$ git init
$ git add . && git commit -m "Deploying to Heroku"

Step 6 - Deploy to Heroku.

Create a Heroku application using heroku create [project_name] e.g.

$ heroku create go-currency
$ git push heroku master

You can then proceed to test your app using https://[project_name] i.e.

You can check the sample website

Source code available at

If you find this useful, kindly share and repost. Thank you 😊!

NOTE: Previously posted on Medium