Tetherd
Tetherd keeps containers attached to the network of the container they route through, automatically restarting or rebuilding apps that use a VPN sidecar (such…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
45/100 Fair
- Maintained
- 79last commit 23 days ago
- Popular
- 123 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 208 GB minimum RAM, runs on ARM
Availability: platform listings confirmed today, links checked 25 days ago
- GitHub stars
- 3
- Open issues
- 0
- Last commit
- 2026-10-29
- Latest release
- v0.1.4
- License
- MIT
- Activity
- rising
Checked 8 days ago - source: GitHub (Phil-Barker/tetherd)
Resources & Compatibility
Minimum requirements: 8 GB RAM, 3 GB disk. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Stop Rebuild-DNDC first If you were running Rebuild-DNDC, stop it before installing Tetherd, its clean-room successor that reads live Docker config instead of Unraid XML. source
- Docker socket required Tetherd needs access to the Docker socket to watch and restart containers, the same security trade-off as Watchtower. source
- Verify setup and set restart policy After install, run 'docker exec tetherd tetherd doctor' to check the setup, and set the container restart policy to Unless Stopped. source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Can Tetherd be used to replace Rebuild-DNDC?
It is described as a clean-room successor to Rebuild-DNDC, not a fork, and it shares no code. It reads container configuration from Docker rather than Unraid XML templates.
Do I need to expose the Docker socket to the Tetherd container?
Yes, the image talks to the host Docker socket. It runs as root for the same reason Watchtower does, because the socket is typically root:docker mode 660 and Unraid will not set --group-add for you.
How do I tell Tetherd which VPN container is the provider?
Set the TETHERD_PROVIDER environment variable to the provider container name, such as gluetun. The Docker run example uses TETHERD_PROVIDER=gluetun.
Will Tetherd delete my app container if the VPN container restarts?
No. If the provider container is only restarted, Tetherd repairs the dependent container with a plain docker restart. It rebuilds only when the provider has been recreated with a new container ID, and it renames the existing container aside rather than deleting it.
Do I need extra Unraid mounts for notifications or templates?
On Unraid, also mount notifications, the webGui marker, and user templates if you want the notification bell and a template audit.
Answers sourced from github.com
Community
Collected 43 days ago - public community threads