# Headscale

> Headscale self-hosted Tailscale control server reference. Run your own WireGuard mesh VPN. Covers config, user/node management, preauth keys, OIDC SSO, ACL policies, DNS, DERP relay setup, Docker Compose deployment, and REST API.

- Skill: `bytesagain/headscale` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bytesagain/headscale`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bytesagain/headscale/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: bytesagain (https://skillmd.com/u/bytesagain)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/bytesagain/headscale

---


# Headscale Reference

Self-hosted Tailscale control server.

## Commands

| Command | Description |
|---------|-------------|
| `intro` | Overview, comparison |
| `setup` | Config, users, nodes |
| `client` | Clients, ACLs, Docker, API |