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…

  • Infrastructure
  • Tools & Utilities
Tetherd keeps containers attached to the network of the container they route through, automatically restarting or rebuilding apps that use a VPN sidecar (such as --network container:gluetun) whenever that container restarts.

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

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