Headscale Backup

by magnus919

Headscale Backup is a DevOps skill for Claude Code, published by magnus919 in agent-skills.

40 stars6 forkson magnus919/agent-skillsAdded 2026/07/18+18% in starsRepository updated 2026/08/11

View source on GitHub Download repo ZIP

agent-skillsagentskillsai-agentsautomationllm

Install in seconds

Install Headscale Backup

Copy Headscale Backup into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/magnus919/agent-skills/tree/main/bundles/tailscale/skills/headscale-backup ~/.claude/skills/headscale-backup

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/magnus919/agent-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: bundles/tailscale/skills/headscale-backup/SKILL.md in magnus919/agent-skills
Installs to: ~/.claude/skills/headscale-backup
Collection: One of 33 skills cataloged from this repository
Category: DevOps — 1075 skills

What Headscale Backup does

Provides scripts for backing up, restoring, and migrating Headscale installations, including SQLite database, configs, and TLS certificates. Use before upgrades or for disaster recovery.

Headscale Backup is cataloged under DevOps on DirSkills. Headscale Backup comes from a repository tagged agent-skills, agentskills, ai-agents, automation and llm.

Documentation

README

Excerpt

Headscale state is stored in SQLite (its database), config.yaml, policy.json, and TLS certificates. Regular backups are critical before upgrades, as database corruption or misconfiguration can result in complete loss of node registration and routing state. This skill provides three scripts covering the full lifecycle: backup, restore, and migration.

Backup Contents

A complete backup tarball includes:

SQLite DB — Full node state, users, routes, pre-auth keys, API keys
config.yaml — Headscale server configuration
policy.json — ACL policy file (if present)
Certs and keys — TLS certificate, private key, and node private key (/var/lib/headscale/)
DERP map — DERP configuration file (if customized)

Backup Methods

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Headscale Backup

What else does magnus919 publish alongside Headscale Backup?
Headscale Backup is one of 33 skills that DirSkills catalogs from magnus919/agent-skills, the repository it ships in. Its siblings there include ADR Authoring, API Design and Evolution and ARR CLI. Each one is a separate skill with its own page in this directory, installs the same way Headscale Backup does, and is maintained by magnus919 in that same repository. The rest of the collection is listed on the magnus919/agent-skills page.
How does Headscale Backup compare to other DevOps skills?
Headscale Backup ranks #1031 by stars among the 1075 DevOps skills in this catalog. The most-starred ones next to it are Backend Patterns, API Connector Builder and Migration. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Headscale Backup against them. Open each page to compare what they document and how they install.