Traefik-mhos (Multi HOSts) helps you use a single traefik for proxying multiple docker hosts (withtout swarm or k8s).

Inspired by jittering/traefik-kop.

• Introduction
  • Usage
  • Environment Variables
  • Port discovery
  • API/Frontend

Create a Redis database alongside your Traefik instance and add it as a provider:

services:
  db:
    image: redis:latest
    command: redis-server --requirepass password
    ports:
      - "6379:6379"
    volumes:
      - ./redis_data:/data

  traefik:
    image: traefik
    command:
      - --providers.redis.endpoints=db:6379
      - --providers.redis.password=password
    ports:
      - "80:80"
      - "443:443"

| You can also add it through Traefik static configuration.

Then setup traefik-mhos on another docker host:

services:
  traefik-mhos:
    image: ghcr.io/zareix/traefik-mhos
    environment:
      - REDIS_ADDRESS=${REDIS_ADDRESS}
      - REDIS_PASSWORD=${REDIS_PASSWORD}
      - REDIS_DB=${REDIS_DB}
      - HOST_IP=${HOST_IP}
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

traefik-mhos can also work in "pull" mode, where it runs on the same host as traefik and connect to multiple docker hosts through their docker API (exposed with something like docker-socket-proxy).

To use this, just set the DOCKER_HOSTS environment variable to point to the remote docker host (for example: tcp://X.X.X.X.2375,tcp://Y.Y.Y.Y:2376).

HOST_IP is not needed in this mode and is determined automatically from the docker host connection.

services:
  traefik-mhos:
    image: ghcr.io/zareix/traefik-mhos
    environment:
      - REDIS_ADDRESS=${REDIS_ADDRESS}
      - REDIS_PASSWORD=${REDIS_PASSWORD}
      - REDIS_DB=${REDIS_DB}
      - DOCKER_HOSTS=tcp://X.X.X.X:2375,tcp://Y.Y.Y.Y:2376

Right now, traefik-mhos only reads the traefik.http.services.<service-name>.loadbalancer.server.port label. Be careful, this port needs to point to the host's port, not to the internal container's port (contrary to the traefik version of this label).

If this label is not found, traefik-mhos will default to the first exposed port of the container.

Traefik-mhos also exposes a simple API and frontend to list current hosts and their services.

The API and the frontend are available on port 8888 by default. You can change the port by setting the PORT environment variable.

Routes:

• GET /api/heath: Health check
• GET /api/hosts: List all hosts with their services
• GET /: Frontend