$ show hassio-addons/app-tailscale
This is a Home Assistant addon that runs Tailscale inside a supervised container, providing a zero-config VPN for building secure networks. The addon orchestrates multiple processes via s6-overlay: tailscaled, a web UI, nginx for ingress, and dnsmasq for MagicDNS proxying. It handles complex networking including iptables DNAT for forwarding tailnet connections to the host, MSS clamping, subnet route protection to avoid collisions with tailnet routes, and Tailscale Serve/Funnel for exposing Home Assistant with TLS. It also supports Taildrop file sharing and Taildrive directory sharing. The architecture is a single container with tightly integrated services, all configured through Home Assistant's addon options. The codebase is well-structured with robust error handling and health checks, but is tightly coupled to the Home Assistant Supervisor environment via bashio and the hassio-addons base image.
The LLM identified 1 files worth highlighting for reuse:
A healthcheck script that uses Tailscale's status JSON to determine if the service is running and online, with configurable timeouts for offline detection. It demonstrates a robust pattern for container health checks that can be adapted to other services: it tracks timestamps of startup and last online state, and fails after defined periods if never connected or if connection is lost. The script is self-contained (only depends on bashio for logging) and could be extracted with minimal modification to any container that needs to monitor a daemon's liveness via its status API.