How to Install Traefik on Alpine Linux

This tutorial will guide you through the process of installing Traefik on Alpine Linux latest version. Traefik is an open-source edge router and load balancer that helps with the automation of your application deployment. It provides many features like routing, SSL termination, load balancing, and much more.

Prerequisites

Before you start, ensure that you have the following:

  • A server running Alpine Linux latest version.
  • Root access to your server.
  • A user with sudo privileges.

Step 1: Install Docker

Traefik runs on Docker, so the first step is to install Docker on your Alpine Linux server. Run the following command:

sudo apk add docker

Once the installation is complete, start the Docker daemon using:

sudo service docker start

You can check the status of the Docker daemon by running:

sudo service docker status

Step 2: Install Traefik

Now that Docker is installed, you can proceed with installing Traefik. You can use the following command to download and install the latest version of Traefik:

sudo docker run -d -p 8080:8080 -p 80:80 -p 443:443 \
-v /var/run/docker.sock:/var/run/docker.sock \
traefik:v2.5

The above command pulls Traefik from the Docker hub and starts it on your server. The -d flag runs Traefik in the background, whereas the -p flag exposes the necessary ports. The -v flag creates a volume that lets Traefik access the Docker socket file.

Step 3: Test the Traefik Installation

To verify that Traefik is installed and running, open a web browser and go to the following URL:

http://your-server-ip-address:8080/dashboard/

You should now be seeing the Traefik dashboard.

Step 4: Configuring Traefik

You can now start configuring Traefik to suit your needs. There are many configuration options available, but we'll cover some basic ones:

Creating a Load Balancer

To create a load balancer, you'll first need to create a Docker network:

sudo docker network create my-network

Next, you'll create a Docker container and attach it to the network you just created:

sudo docker run -d \
--name=my-container \
--network=my-network \
nginx

Finally, you'll configure Traefik to route HTTP traffic to your container. Create a file named traefik.yml and add the following snippet:

providers:
  docker:
    endpoint: "unix:///var/run/docker.sock"
    exposedByDefault: false

http:
  routers:
    my-router:
      rule: "Host(`example.com`)"
      service: my-service

  services:
    my-service:
      loadBalancer:
        servers:
          - url: "http://my-container:80"

In the above example, we're telling Traefik to route traffic that comes to example.com to the service my-service, which is our Nginx container.

You can now start Traefik again, this time providing the configuration file:

sudo docker run -d -p 8080:8080 -p 80:80 -p 443:443 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(pwd)/traefik.yml:/etc/traefik/traefik.yml \
traefik:v2.5

This command starts Traefik and mounts the configuration file at /etc/traefik/traefik.yml.

Conclusion

You've now successfully installed Traefik and configured it to route traffic to your Nginx container. Traefik is a powerful tool that can simplify your application deployment process, and we hope this tutorial has been helpful in getting started with it on Alpine Linux.