Madukoma Blessed
Madukoma Blessed's Blog


Madukoma Blessed's Blog

How I deploy my Golang API (to Heroku)

How I deploy my Golang API (to Heroku)

Madukoma Blessed's photo
Madukoma Blessed
·Sep 9, 2022·

5 min read

For some time, I had issues deploying my Go code to Heroku, but I finally got it after a lot of trial and error. This article serves as a guide to both me and other Go devs who at some point had a little issue deploying their services to Heroku.

Features and tools we will use:

  • Go
  • Heroku
  • GitHub (optional but important in your developer life)


  • Heroku account
  • Understanding of the Go language

The finished project can be found on GitHub.

Setting of Project:

  1. We start by making sure Go is correctly installed. To check if Go is installed, run:

    go version

    You should see the output:

    ![go-version-command.png]( align="left")
    • Create a folder called go-deploy, cd into the folder and create a main.go file. Note: We would not implement any conventional package structure for this article as this is simply deploying a basic Go app to Heroku, but you can check the following resources for more info: Ardan lab - Service, Reposaur.
  2. After creating the main.go, we will install our dependencies:

    • We start by setting up our go mod file by running this command in our terminal or cmd):

      go mod init go-deploy

      If I check the files in my current directory, I will see a new file named go.mod:



I added this tag // +heroku goVersion go1.18 to inform Heroku of the specific Go version to use when deploying the application.

  • I am using the Chi router but you can use any router of your choice (Gorilla mux is a popular choice).

    go get
  • Create a .env file, which stores our port address to run our code server:

    env file.png After creating the .env and populating it with some confidential data, install the godotenv package to load the .env file into our code:

    go get

Running the above command, check your go.mod file, there should be a new require addition to it. Packages 'gotten' in Go will be registered there which allows the package to be used.

After installing the needed dependencies, we will create the API handler named home in our main.go file:

package main

import (


// home handler is unexported due to no other package requiring the handler
func home(w http.ResponseWriter, r *http.Request) {
    response := "Home page"

func main() {

    // load our env
    err := godotenv.Load()
    if err != nil {
        log.Fatal("Unable to load env file")

    // create a new router
    router := chi.NewRouter()
    router.HandleFunc("/", home)

    // portNumber
    var portNumber = os.Getenv("PORT")

    portNumber = ":" + portNumber
    // create our server
    srv := &http.Server{
        Addr:    portNumber,
        Handler: router,

    fmt.Printf("Starting server on port %s\n", portNumber)
    err = srv.ListenAndServe()
    if err != nil {


We start the application server by running:

go run main.go


Testing to see if the handler works by running our request (I use a VScode extension called Thunder Client, you can use Postman):


Deploying to Heroku

Seeing as the application works, it is time to deploy to Heroku: Make sure you have an account with Heroku, if you do not, create one.

  1. Install the Heroku CLI: For Mac users, run this command in the terminal:

    brew tap heroku/brew && brew install heroku

    For Windows and Linux users, visit the installation guide.

  2. Verify the installation of the Heroku CLI:

    heroku version.png

    After verification, log into the CLI by running heroku login in your terminal:

    heroku login 1.png

    A browser window will open and ask you to login. Once login is successful, you can perform Heroku commands in your terminal.

  3. Not an important step but will help you in your dev life: Create a Github account and create a Github repository.

  4. Initialize a git repository in your terminal by running:

    git init
  5. Add and commit the files you have to the empty repository created:
    git add .
    git commit -m "deploying to heroku"
  6. Create a new branch called main which by default Heroku deploys from:

    git branch -M main
  7. This step is if you want to push to Github (remember step 3): Add the Github repository you created and push to the Github branch:

    git add origin<your-name>/<repo-name>.git
    git push origin main

    Github has a new security setting called: Personal access token, read on it before continuing to allow you push to Github without a password.

  8. Create a new Heroku app from the CLI:

    heroku create -a <name-of-your-app>


    heroku apps:create <name-of-your-app>

    heroku create app.png

  9. Add the created Heroku app to this project:

    heroku git:remote -a <name-of-your-app>

    heroku add to project.png For more information on this: Deploying with Git

  10. Push to Heroku:

    git push heroku main




Running the deployed application, our API has been successfully deployed to Heroku:

api deployed.png

Why I mentioned using Github is because Heroku allows automatic deploys from Github by creating a pipeline, therefore, instead of running the commands above after every significant change, you can just push to Github and the change will automatically be deployed.


In this article, we learned how to deploy a Go app to Heroku. Although there was no conventional package structure followed, Heroku has a guide for Go devs still using dep which is linked here. For further enquiries, Heroku has a well-detailed article on this topic, although it deploys the Gin framework. Comments are appreciated. Until next time, happy coding!

Share this