Master Docker and Golang Usage with Best Practices

Antony Shikubu

GO, GOLANG Solutions

Welcome to our tutorial on Docker and Golang! Here, we will guide you through creating a golang dockerfile, allowing your Golang applications to run seamlessly inside Docker containers. We aim to simplify docker golang integration, starting from setting up your environment, explaining basic and advanced concepts, to deploying a full-fledged application.

In this hands-on guide, you will learn to dockerize a Golang application (golang docker), ensuring it’s efficiently built and deployed. We will cover best practices, troubleshooting, and continuous integration to make your journey as smooth as possible. Each part of the tutorial is designed to enhance your knowledge and skills in integrating Docker with Golang applications effectively and confidently.



To be able to follow along this article, ensure you have a basic understanding of how web servers work, because your application is  a simple web application. Apart from web server knowledge , please ensure you have the following technologies installed in your machine.

  1. Go runtime version 1.18.9  or later installed
  2. Docker version  installed


Creating a Golang Application

In this section, we are going to craft a straightforward web application using Golang. This foundation will later be instrumental when we dive into the dockerization process using a golang dockerfile.

A well-structured application is vital, especially when it comes to integrating technologies like "docker golang." A sensible directory structure helps in maintaining clarity, organization, and efficiency, providing a smooth pathway for subsequent dockerization steps.

Create application folder and navigate into it

$ mkdir go-docker && cd go-docker

Create main.go

$ touch main.go

Update your main.go:

package main

import (

func handler(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintln(w, "Welcome to our Golang Docker Tutorial!")

func main() {
	http.HandleFunc("/", handler)
	fmt.Println("Server is running on http://localhost:8080")
	http.ListenAndServe(":8080", nil)

In this snippet, our Golang application is set up as a basic HTTP server. It listens on port 8080 and has a single endpoint, the root ("/"), which when hit, will respond with a welcome message, "Welcome to our Golang Docker Tutorial!"

Initialize Go module

$ go mod init go-docker
$ go mod tidy


Dockerizing a Golang Application

Creating a golang dockerfile is a fundamental step in dockerizing a Golang application. The Dockerfile contains a set of instructions to build the Docker image of our application. Below is an example of a Dockerfile specifically tailored for our Golang application:

We are creating this Dockerfile inside /go-docker directory:

# Use the official Golang image as a base
FROM golang:latest 

# Set the working directory in the container
WORKDIR /go-docker

# Copy the local package files to the container’s workspace.
COPY . . 

# Build the Go app
RUN go build -o main . 

# Run the binary program produced by `go build`
CMD ["./main"]

In this Dockerfile:

  • We start with a base image containing Golang preinstalled.
  • Set a working directory in the container.
  • Copy our application into the container.
  • Build the application.
  • And, finally, run the application.

Building and Running a Docker Container

With our golang dockerfile ready, the next step in the "docker golang" process is to build the Docker image and run it as a container. Here are the commands you would use:

docker build -t go-docker .
docker run -p 8080:8080 go-docker

This will build the Docker image from the Dockerfile and run it as a container, mapping port 8080 on your machine to port 8080 on the container.


Multi-Stage Builds in a Golang Dockerfile

Multi-stage builds in a golang dockerfile are a powerful feature that Docker provides to create efficient and optimized Docker images, especially crucial for "docker golang" applications. Utilizing multi-stage builds enables us to keep our final application image clean and small, containing only the necessary components to run the application.

How Multi-Stage Build Works

A multi-stage build includes multiple FROM statements within a single "golang dockerfile." Each FROM statement initiates a new build stage, allowing for multiple intermediate images, but only the last stage determines the final image.

Example of Multi-Stage Build in a Golang Dockerfile

# First Stage: Building the Go Application
FROM golang:alpine AS builder


# Download dependencies
COPY go.mod go.sum ./
RUN go mod download

# Copy source code and build the application
COPY . ./
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o myapp .

# Second Stage: Running the Go Application
FROM alpine:latest


# Copy the binary from the builder stage
COPY --from=builder /src/myapp .

CMD ["./myapp"]


  • First Stage (FROM golang:alpine AS builder): In this initial stage, a base Golang image is used to compile the application. Dependencies are managed, and source code is compiled into a binary. The builder alias is assigned to reference this specific stage later.
  • Second Stage (FROM alpine:latest): This stage utilizes a smaller, minimal Alpine image to reduce the final image size. Here, only the compiled binary from the first stage is copied into this stage, ensuring that the final image includes only the necessary executable, leading to a cleaner and more efficient "golang docker" image.


Using Docker Compose with a Golang Application

Docker Compose simplifies the process of managing multi-container Docker applications, such as a Golang application paired with a database or other services. With a Compose file, you can define a multi-container application in a single file, then spin up your application with a single command (docker-compose up).

Consider you have a golang docker application, and you want to connect it with a database. You would define both services in a docker-compose.yml file. Here is an illustrative example:

# Specifies the version of Docker Compose to be used.
version: '3' 

# Begins the services block, defining each service to run in separate containers.

  # Names the first service, related to the Go application.
    # Specifies that the service will be built from a Dockerfile.
      # Sets the build context to the current directory, where the Dockerfile and source code are located.
      context: . 
      # Names the Dockerfile to be used for building the image.
      dockerfile: Dockerfile 
    # Specifies the ports to be exposed or mapped.
      # Maps port 8080 on the host to port 8080 on the container for the Go application.
      - "8080:8080" 
  # Names the second service, related to the database.
    # Specifies the image to be used, pulling the latest Postgres image from Docker Hub.
    image: "postgres:latest" 
    # Specifies the ports to be exposed or mapped.
      # Maps port 5432 on the host to port 5432 on the container for the Postgres database.
      - "5432:5432" 

To start the services defined in the docker-compose.yml, run the following command in the directory where the file is located:

docker-compose up

By using Docker Compose in the "docker golang" scenario, you enhance the manageability and scalability of the application, ensuring that all components of your multi-container application are correctly configured and run seamlessly together in a unified environment.


Best Practices - Efficient Golang Dockerfile

Creating efficient Dockerfiles is crucial for building streamlined and performant Docker images. Especially when it comes to "docker golang" applications, having a well-optimized Dockerfile can significantly reduce the image size, build time, and improve the overall runtime performance of the "golang docker" application. Let’s delve into crafting an efficient "golang dockerfile" with an illustrative example:

# Start from the official Golang base image for the build stage
FROM golang:alpine AS builder

# Set the working directory inside the container

# Copy the Go mod and sum files, then download dependencies
COPY go.mod go.sum ./
RUN go mod download

# Copy the source code into the container
COPY . .

# Build the Go binary with necessary compiler flags for optimization
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o go-docker .

# Use a minimal alpine image for the runtime stage
FROM alpine:latest

WORKDIR /root/

# Copy the binary from the builder stage
COPY --from=builder /app/go-docker .

# Expose the application on a specific port

# Command to run the application
CMD ["./go-docker"]


This golang dockerfile uses multi-stage builds to create an efficient Docker image:

Build Stage (FROM golang:alpine AS builder):

  • This stage uses the official Golang Alpine image. Alpine images are lighter than the regular images, contributing to a smaller final image size.
  • Dependencies are downloaded separately before the application code is copied, leveraging Docker cache efficiently and speeding up subsequent builds if dependencies don't change.

Runtime Stage (FROM alpine:latest):

  • A minimal Alpine image is used to run the application, keeping the image size small.
  • Only the compiled binary is copied from the build stage, ensuring that only necessary files are included in the final image.

Other Optimizations:

  • Compiler flags like CGO_ENABLED=0 and -installsuffix cgo are used during the build process to produce a statically linked binary that's more portable and secure.


Continuous Integration/Continuous Deployment (CI/CD)

Implementing CI/CD in "docker golang" applications streamlines the development to deployment workflow, ensuring more robust and reliable software. CI/CD automates the building, testing, and deployment of applications, and integrating it with Docker enhances the consistency and portability of the deployments.

Let's consider a scenario where we implement a CI/CD pipeline using GitHub Actions, a popular CI/CD tool, for a "golang docker" application.


name: CI/CD Pipeline

      - main

    runs-on: ubuntu-latest

      - name: Check Out Code
        uses: actions/checkout@v2

      - name: Set Up Docker Buildx
        uses: docker/setup-buildx-action@v1

      - name: Login to DockerHub
        uses: docker/login-action@v1 
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Build and Push Docker Image
        id: docker_build
        uses: docker/build-push-action@v2
          push: true
          context: .
          file: ./Dockerfile
          tags: username/go-docker:latest

      - name: Deploy to Server
        run: |
          ssh username@your.server.ip "docker pull username/go-docker:latest && docker restart go-docker"


  • Check Out Code: This step checks out the repository code, making it available to the workflow.
  • Set Up Docker Buildx: Configures Docker with Buildx to support advanced build features like building multi-platform images.
  • Login to DockerHub: Authenticates against DockerHub using provided credentials. It uses secrets stored in the GitHub repository.
  • Build and Push Docker Image:
    • Utilizes the "golang dockerfile" to build the Docker image.
    • The image is then pushed to DockerHub.
  • Deploy to Server:
    • This step pulls the latest image from DockerHub and restarts the container on the server. It assumes that a "docker golang" container is already running on the server.


Advanced Topics: Scaling and Monitoring Golang Applications with Docker

Scaling Golang Applications using Docker Swarm/Kubernetes

Scaling applications is essential for optimizing performance and managing increased loads efficiently. Docker Swarm and Kubernetes are popular orchestration tools that manage, scale, and maintain containerized applications, including "docker golang" applications.

Example: Scaling with Docker Swarm

# Initializing Docker Swarm
docker swarm init

# Deploying the Golang Application
docker service create --name go-docker --publish 8080:8080 --replicas 3 username/go-docker:latest


  • Docker Swarm simplifies orchestration by turning a pool of Docker hosts into a single virtual host.
  • In this example, we create a service named go-docker, specifying the number of replicas and the image to use.
  • The --replicas 3 option ensures that three instances of the "golang docker" application are running, enhancing availability and load balancing.

Monitoring and Logging in Docker and Golang Applications

Example: Docker Logging with Golang Applications

You can direct logs from your "golang docker" application to a central location for easier access and analysis.

Dockerfile Setup

# Using multi-stage builds for an efficient golang dockerfile
FROM golang:alpine AS builder
# Other necessary Dockerfile commands

Running the Container with Log Options

docker run -d --name go-docker \
--log-driver json-file \
--log-opt max-size=10m \


  • This configuration ensures that the logs generated by your "golang docker" application are managed by Docker. Docker’s json-file logging driver is used in this example.
  • Log options like max-size are specified to manage the size of the logs, ensuring that they don’t consume too much disk space.


Frequently Asked Questions: Docker and Golang

What is the purpose of using a multi-stage build in a Golang Dockerfile?

Multi-stage builds in a "golang dockerfile" allow you to use multiple FROM statements in a single Dockerfile. It helps in creating lighter and more efficient Docker images by separating the building stage from the final runtime stage, ensuring only the necessary components, like the compiled binary, are included in the final image.

How do I manage dependencies in a Docker Golang application?

Managing dependencies in a "docker golang" application can be done using Go modules. In your Dockerfile, you can copy the go.mod and go.sum files and run go mod download to download the dependencies before copying the entire application code. This approach utilizes Docker cache effectively and speeds up the build process.

How can I scale my Golang application using Docker?

Scaling a "golang docker" application can be achieved using container orchestration tools like Docker Swarm or Kubernetes. These tools allow you to manage multiple instances of your application, distributing the load, ensuring high availability, and managing the deployment of updated versions seamlessly.

How do I troubleshoot a crashing Golang application in a Docker container?

You can troubleshoot a crashing "golang docker" application by checking the logs using the docker logs <container_id> command. Additionally, tools like docker stats and other monitoring solutions can help identify resource constraints or other issues causing the application to crash.

Can I use Docker Compose to manage multi-container Golang applications?

Yes, Docker Compose is a tool for defining and running multi-container Docker applications, making it suitable for managing "golang docker" applications that interact with databases, caches, or other services. You can define the services, networks, and volumes in a docker-compose.yml file and manage the application using various Docker Compose commands.

How can I optimize the build time of my Docker Golang application?

Optimizing build time in "docker golang" applications can be done by leveraging Docker’s build cache, using multi-stage builds, and managing dependencies effectively by downloading them before copying the entire application code. Additionally, choosing lighter base images and minimizing the number of layers can also help in reducing build times.

How do I ensure that my Golang Docker images are secure?

Ensuring the security of "golang docker" images involves using official or trusted base images, keeping images up-to-date, minimizing the runtime by only including necessary components, and using tools like docker scan to identify and fix vulnerabilities in the images and dependencies.



Throughout this comprehensive guide, we navigated the intricate waters of creating, optimizing, and deploying "docker golang" applications. From constructing a solid "golang dockerfile" to leveraging multi-stage builds for efficient images, we uncovered strategies essential for robust "golang docker" application development.

We explored topics such as structuring Golang applications, writing Dockerfiles, managing dependencies, and orchestrating multi-container applications with Docker Compose. Advanced discussions delved into scaling applications using Docker Swarm/Kubernetes, implementing CI/CD pipelines, and advanced monitoring and logging techniques.

For further reading you can refer these resources:

  • Docker Documentation : Explore the official Docker documentation to delve deeper into concepts like multi-stage builds, Docker Compose, and Docker Swarm.
  • Golang Documentation For a comprehensive understanding of Golang application development, refer to the official documentation.
  • Docker Compose Documentation: Uncover more about orchestrating multi-container Docker applications using Docker Compose.


Views: 54

Antony Shikubu

He is highly skilled software developer with expertise in Python, Golang, and AWS cloud services. Skilled in building scalable solutions, he specializes in Django, Flask, Pandas, and NumPy for web apps and data processing, ensuring robust and maintainable code for diverse projects. You can connect with him on Linkedin.

Can't find what you're searching for? Let us assist you.

Enter your query below, and we'll provide instant results tailored to your needs.

If my articles on GoLinuxCloud has helped you, kindly consider buying me a coffee as a token of appreciation.

Buy GoLinuxCloud a Coffee

For any other feedbacks or questions you can send mail to

Thank You for your support!!

Leave a Comment

GoLinuxCloud Logo

We try to offer easy-to-follow guides and tips on various topics such as Linux, Cloud Computing, Programming Languages, Ethical Hacking and much more.

Programming Languages