NAME
tether
A central configuration hub for distributed Traefik setups.
DESCRIPTION
Tether is the central hub of a distributed Traefik setup. It collects information from every server you run and points Traefik at the right app for each request.
You can think of it as a central operator. Multiple servers running Tetherd tell Tether which apps are live, and Tether hands Traefik one master list of all of them.
Tether is for anyone running several physical servers or VPS instances without wanting the complexity of Kubernetes or Docker Swarm. Forward port 443 to a single server and let simple HTTP heartbeats replace KV stores such as Consul or Redis.
FEATURES
- One public IP: forward port 443 to a single server running Traefik
- Auto-discovery of apps running on your other servers
- Simple HTTP heartbeats with no KV stores such as Consul or Redis
- Central operator pattern with Tetherd agents reporting from every server
- Shared secret token for connecting agents
- Optional web UI that can be turned off
- Local file support for manual Traefik rules
QUICK START
services:
tether:
image: ghcr.io/mizuchilabs/tether:latest
ports:
- 3000:3000
environment:
- TETHER_TOKEN=your-secret-password
restart: unless-stoppedCONFIGURATION
| Name | Description |
|---|---|
| TETHER_TOKEN | Shared secret for agents to connect. Strongly recommended. Also --token. |
| TETHER_PORT | Port Tether listens on. Also --port. Default: 3000. |
| TETHER_NO_WEB | Disable serving the web UI. Also --no-web. Default: false. |
| TETHER_CONFIG | Optional local file for manual Traefik rules. Also --config. Default: /data/dynamic.yml. |
| TETHER_DEBUG | Enable detailed logging. Also --debug. Default: false. |
RELATED
- tetherdThe lightweight agent for the Tether ecosystem.
- Distributed Traefik with Tetherblog/tether
LINKS
[github]https://github.com/mizuchilabs/tetherSelf-hosting tether 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.