Traefik-Kop

Traefik-Kop

Docker app from martial's Repository

Overview

A dynamic docker to redis to traefik discovery agent. Solves the problem of running a non-Swarm/Kubernetes multi-host cluster with a single public-facing traefik instance. traefik-kop solves this problem by using the same traefik docker-provider logic. It reads the container labels from the local docker node and publishes them to a given redis instance. Simply configure your traefik node with a redis provider and point it to the same instance, as in the diagram in the project's README. This is just an Unraid template for the traefik-kop docker image published by the author on GitHub. The project has no WebUI. See the "Propagating labels from Docker instances not on the Traefik host" section of https://www.gkr.one/blg-20240831-traefik for an example of usage (some default values are the same as the example). Extra environment variables added to reflect the project README's "Configuration" section. Feel free to delete environment variables you don't need in the template below. Recommended to keep at minimum: KOP_HOSTNAME, REDIS_ADDR, BIND_IP.

Requirements

Traefik, Redis (or Valkey)

Runtime arguments

Network
docker
Shell
bash
Privileged
false

Template configuration

Docker socketPathro

Docker Socket (read-only) access to find the docker containers and labels automatically..

Target
/var/run/docker.sock
Default
/var/run/docker.sock
Value
/var/run/docker.sock
KOP_HOSTNAMEVariable

Hostname to identify this node in redis

Default
foo
Value
foo
REDIS_ADDRVariable

Redis address

Default
192.168.222.11:6379
Value
192.168.222.11:6379
BIND_IPVariable

IP address to bind services to

Default
192.168.222.99
Value
192.168.222.99
REDIS_USERVariable

Redis user

Default
default
Value
default
REDIS_PASSVariable

Redis password (if needed, delete if not)

REDIS_DBVariable

Redis DB number

Default
0
Value
0
REDIS_TTLVariable

Redis TTL (in seconds)

Default
0
Value
0
KOP_POLL_INTERVALVariable

Poll interval for refreshing container list

Default
60
Value
60

Categories

Details

Repository
ghcr.io/jittering/traefik-kop:latest
Last Updated2026-06-02
First Seen2025-12-05

Run Traefik-Kop on Unraid.

Traefik-Kop is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.