headtotails documentation

headtotails is a lightweight translation layer that exposes Tailscale API v2 semantics on top of Headscale gRPC.

What this enables

Run tools expecting api.tailscale.com/api/v2 against self-hosted Headscale.
Use Tailscale Kubernetes operator patterns with Headscale + headtotails routing.
Keep Headscale as control plane while exposing a compatible management API surface.

Start here

Usage guide for quick local and binary starts.
Configuration reference for all environment variables.
Kubernetes guide for Gateway API based deployment.
Real-world examples — tested walkthroughs for exposing services, exit nodes, and subnet routers.

Repository: github.com/alam0rt/headtotails