cd ..
tetherd(1)Mizuchi Labs Manualtetherd(1)
mizuchi:$ ~ man tetherd

NAME

tetherd

The lightweight agent for the Tether ecosystem.

★ 7 · last pushed 2026-09-22

DESCRIPTION

Tetherd is the lightweight agent you run on worker servers. It watches your Docker containers and tells the central Tether server where they are so Traefik can find them.

Run Tetherd on every server that hosts Docker containers. It reads the Traefik labels on your containers, detects the server IP on its own, and sends that information to Tether.

A single Traefik instance on a different machine can then route traffic to these containers seamlessly.

FEATURES

  • Watches Docker containers and reports their Traefik labels to the central Tether server
  • Automatic detection of the server IP address
  • Host networking recommended for reliable IP detection
  • Deploy apps with standard Traefik labels and nothing more
  • Token that must match the Tether server
  • Isolated environments to group servers
  • Manual override for the host IP
  • Debug flag for detailed logging

QUICK START

Docker Compose
services:
  tetherd:
    image: ghcr.io/mizuchilabs/tetherd:latest
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      - TETHERD_SERVER=http://<TETHER_SERVER_IP>:3000
      - TETHERD_TOKEN=your-secret-password
    restart: unless-stopped
Deploy an app
services:
  my-app:
    image: nginx
    ports:
      - "8080:80"
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.my-app.rule=Host(`my-app.com`)"

CONFIGURATION

NameDescription
TETHERD_SERVERURL of the central Tether server. Also --server. Default: http://127.0.0.1:3000.
TETHERD_TOKENToken matching the Tether server. Required. Also --token.
TETHERD_HOST_IPManual override for this server IP. Also --host-ip. Default: auto.
TETHERD_ENVIRONMENTGroup servers into isolated environments. Also --env. Default: default.
TETHERD_DEBUGEnable detailed logging. Also --debug. Default: false.

RELATED

  • tetherA central configuration hub for distributed Traefik setups.

LINKS

GitHub[github]https://github.com/mizuchilabs/tetherd
SELF-HOSTED VS COMMERCIAL

Self-hosting tetherd is free under the Apache-2.0 license. Run it on your own iron. Commercial licensing, support, and managed offerings for businesses are on the business page.