# Tetherd

Tetherd is a self-hosted infrastructure app. 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... It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/2530/tetherd

## Description

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.

## Health score

45/100 (Fair), based on 4 of 4 factors.
- Maintained: 79 (last commit 23 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (8 GB minimum RAM, runs on ARM)

## Links

- Unraid: https://ca.unraid.net/apps/tetherd-15erkm912ijqkl?q=tetherd
- Docker Hub: https://hub.docker.com/r/philbarker79/tetherd
- GitHub: https://github.com/Phil-Barker/tetherd

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2530/tetherd), the self-hosted and open-source app directory.
