wl-open-sourcewl-open-source/claude-skills/hetzner-server-runbook/SKILL.md

hetzner-server-runbook

Skill0 starsChanged 4 months agoMITView on GitHub

Provisioniert Hetzner-Cloud-Server per hcloud CLI, härtet sie (SSH-Key-only, ufw, fail2ban, Auto-Updates) und deployt Docker-Compose-Anwendungen mit Caddy als Reverse Proxy (automatisches HTTPS). Enthält Runbooks für Backups (Snapshots + restic) und Server-Troubleshooting. Nutze dieses Skill, wenn der Nutzer sagt "setz einen neuen Server auf", "provisioniere einen Hetzner-Server", "deploye die App auf den Server", "härte den Server ab", "richte Backups ein", "der Server ist down" oder ähnliche Wünsche zu Hetzner, VPS-Setup, Linux-Server-Konfiguration oder Docker-Deployment äußert.

Reads credentials
Installs packages

In this repository4 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- meeting-summarySkill
- para-dateiorganisationSkill
- projekt-bootstrapSkill

The file

Create a free account to mount

Files

SKILL.md

Hetzner Server Runbook

Ausführbares Runbook: Claude führt die Schritte selbst aus (hcloud, ssh), aber sichtbar und einzeln. Nie mehrere Schritte stillschweigend bündeln.

Eiserne Regeln

HCLOUD_TOKEN kommt aus der Umgebung (hcloud context oder Env-Var). Token niemals anzeigen, loggen oder in Dateien schreiben.
Bestätigung erforderlich vor jeder Aktion, die Geld kostet oder destruktiv ist: Server/Volumes/Snapshots erstellen, löschen, resizen, DNS ändern. Muster: exakten Befehl zeigen → auf separates Ja warten → ausführen.
Secrets (DB-Passwörter, .env) nur auf dem Server, Dateirechte 600, nie ins Git.
Vor destruktiven Server-Befehlen (rm, docker compose down -v, ufw enable bei aktiver SSH-Session): Konsequenz nennen, bestätigen lassen.

Workflows

Wunsch	Referenz
Neuen Server erstellen	`references/provisionierung.md`
Server absichern/härten	`references/haertung.md`
Docker + Reverse Proxy einrichten	`references/docker-caddy.md`
App deployen / Rollback	`references/deployment.md`
Backups einrichten / wiederherstellen	`references/backups.md`
Fehler diagnostizieren	`references/troubleshooting.md`

Kompletter Neuaufbau = Provisionierung → Härtung → Docker/Caddy → Deployment → Backups, in dieser Reihenfolge. Nach jedem Block kurz verifizieren (steht im jeweiligen Dokument) und dem Nutzer den Stand melden.

Vorbedingungen prüfen (immer zuerst)

hcloud version || echo "hcloud fehlt: brew install hcloud"
hcloud context active || echo "Kein Kontext: hcloud context create <name>"
ls ~/.ssh/id_ed25519.pub || echo "Kein SSH-Key: ssh-keygen -t ed25519"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free