How To Deploy a Golang Web Application with Docker

If you are also a Golang web developer like me, You must be probably knowing that Go code can be compiled into binary code and does not need Go environment to run. Also, we know that Golang web applications will have templates and configuration files. When we have a large number of files in our project, there is the possibility that some of the files may not be synced. This may lead to a lot of errors and issues.

Here comes the role of Docker. By using docker the files can be kept in sync with binary. So we can overcome these type of issues using Docker.

In this Blog, I’m going to discuss how to create Docker container for Golang web application and deploying Docker container.




At first, you need:

Creating simple Golang web application:

For your understanding and demonstration, I have created a sample web application here. This application uses HTML templates for views and exposes routes for the contact form.

Directory structure:

Our web application directory structure looks like,

├── Dockerfile
└── views
     └── forms.html

Content of main.go:

// main.go

package main

import (







// contact details structure

type ContactDetails struct {

 Email   string

 Department string

 Description string


// Execution start with main function

func main() {

 // Handle http requests with home path / with the formHandler function.

 http.HandleFunc("/", formHandler)

 http.ListenAndServe(":8080", nil)


// formHandler is an HTTP handler, it serves form template

func formHandler(w http.ResponseWriter, r *http.Request) {

 _, filename, _, ok := runtime.Caller(0)

 if !ok {

   fmt.Println("No caller information")


 // get template from views directory

 tmpl := template.Must(template.ParseFiles(path.Dir(filename)+"/views/forms.html"))

 if r.Method != http.MethodPost {

   // render template

   tmpl.Execute(w, nil)



 // read field values from form

 details := ContactDetails{

   Email:   r.FormValue("email"),

   Department: r.FormValue("department"),

   Description: r.FormValue("description"),


 // do something with details

 _ = details


 // pass value to form

 tmpl.Execute(w, struct{ Success bool }{true})


Content of forms.html:

<!-- forms.html -->

{{if .Success}}

 <!-- submission response -->

 <h1>Thanks for your message!</h1>


 <!-- Initial render page -->


 <form method="POST">

   <label>Email:</label><br />

   <input type="text" name="email"><br />

   <label>Department:</label><br />

   <input type="text" name="department"><br />

   <label>Description:</label><br />

   <textarea name="description"></textarea><br />

   <input type="submit">



Write a Dockerfile for Docker build:

Now we need to write a Dockerfile for building our Docker image to install and run our Go HTTP server in a Docker container. This Dockerfile contains all the commands required to construct Docker image. So by reading these instructions from Dockerfile Docker builds images.

The content of Dockerfile:

From golang:latest

ADD . /go/src/

# Build the contact_registry command inside the container.

RUN go install

# Run the contact_registry command when the container starts.

ENTRYPOINT /go/bin/contact_registry

# http server listens on port 8080.


 The image name golang:latest means that we are building our image from Golang image with the latest tag.  Then, we install our Golang application to the bin folder of Gopath and setting up the entry point for the app.

Note:  If you are using the docker image for development between your team, you can clone the source inside the image, but if you are using the image for deployment keep the binary files in the image instead of source code.

Build the Docker image:

Run the below-given command, it creates the image from contact_registry directory that builds Docker image.

$ sudo docker build -t reddysai/contact_registry .

The build command reads our instructions from Dockerfile. In the Dockerfile,

  • FROM golang:latest  fetches the golang:latest image.
  • ADD- adds the package source into Gopath of golang image.
  • RUN- builds the Go package.
  • ENTRYPOINT –  set up the entry point for our container for running the reddysai/contact_registry.
  • EXPOSE – exposes port 8080 for HTTP server.

The above process creates an image with name reddysai/contact_registry. It can be used by all the people who work on this application.

The following command allows you to see all the images in the list:

$ sudo docker images

Run and test the Docker image:

Using the following command run the Docker image. We have to publish an external port to container’s port 8080.

$ sudo docker run -p 6060:8080 --rm reddysai/contact_registry

  • Executing this command runs the Docker image. This container exposes application on port 6060.The docker run -runs a container from an image.
  • –rm flag – it will clean container once the container shuts down.
  • The -p 6060:8080 flag – It makes the container get accessed at port 6060.

Visit in your browser with http://localhost:6060/ to see it running.

Write a Dockerfile with Docker multi-stage builds:

Multi-stage builds feature is available in Docker 17.05 version and later versions, It will help to optimize the Dockerfiles and makes it easy to analyze and maintain.

Content of Dockerfile:

# build stage

FROM golang:latest AS builder

# working directory

WORKDIR /go/src/

# install html package

RUN go get -d -v

COPY main.go    .

RUN mkdir -p views

# copy the templates into working directory

COPY views /go/src/

# rebuilt built in libraries and disabled cgo

RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .

# final stage

FROM alpine:latest

# working directory

WORKDIR /go/src/

RUN mkdir -p views

# copy the binary file into working directory

COPY --from=builder /go/src/ .

# copy the templates into working directory

COPY --from=builder /go/src/ /go/src/

RUN cd views && ls -lh

# Run the contact_registry command when the container starts.

CMD ["./main"]

# http server listens on port 8080


Now build the docker image using below command,

Note: Before executing the command check and update the docker version, multi-stage builds supports only Docker 17.05 and later versions.

$ sudo docker build -t reddysai/contact_registry .

Run the docker images using below command,

$ sudo docker run -p 6060:8080 --rm reddysai/contact_registry

Executing the above command runs the Docker image. This container exposes application on port 6060.

Visit in your browser with http://localhost:6060/ to see it running.

Check the running containers using the following command,

$ sudo docker ps -a

Run the following command to stop the docker image,

$ sudo docker stop CONTAINER ID

Push the docker image into Docker Hub

$ sudo docker push reddysai/contact_registry

Now, you can run this docker image easily like,

$ sudo docker run -p 6060:8080 --name test --rm reddysai/contact_registry

Now we have learned to create a Docker container for Golang web application and deploying Docker container. You can also deploy this application to your servers by following the same procedure. For this the server needs a Docker installed.

Have any doubts or queries? Comment below. For more on golang follow our blog. Our golang experts at Agira have written many informative blogs on Golang.

READ NOW >>  Benefits Of Using Docker And Kubernetes Together