laguagu/claude-code-nextjs-skills / skills/hetzner-cloud
hetzner-cloud
VerifiedManage Hetzner Cloud infrastructure with the `hcloud` CLI — servers, networks, firewalls, load balancers, volumes, DNS zones, SSH keys, primary/floating IPs, snapshots, certificates, placement groups, storage boxes. Use whenever the user mentions Hetzner, hcloud or Hetzner location codes (fsn1, hel1, nbg1, ash, hil, sin), or wants a VPS or cloud server in a project that already runs on Hetzner — even if they don't say "hcloud". CLI-only; not for Hetzner Robot (dedicated servers, separate product and API).
Hetzner Cloud
Use the installed hcloud CLI and its --help/JSON output for current
resource types, locations, flags and pricing. This covers Cloud/DNS/Storage
Box APIs supported by that CLI; dedicated servers/auctions use Hetzner Robot.
Authentication and discovery
Use the authorized project's existing context or HCLOUD_TOKEN. A token in
an env file is not automatically exported. Creating a context normally
prompts; hcloud context create --token-from-env <name> uses the process
token without prompting. Keep tokens out of command arguments/logs.
Confirm project/context before writes. Discover server types, system images,
architecture, location/network zone and price through current CLI/API data
(hcloud server-type list, hcloud location list,
hcloud image list --type system --architecture arm, hcloud all list for the
whole project). Do not quote a remembered server specification or price.
Dependencies and verification
Referenced SSH keys/firewalls/networks must exist before server creation.
Inspect a proposed firewall change against the current rules and retain a
working management path. firewall replace-rules --rules-file replaces the
set, so omitted rules disappear. zone import-zonefile --zonefile likewise
replaces all Zone RRSets; omitted records disappear.
Cloud Firewalls do not yet protect private Network traffic or Load Balancers. Use host/application controls where needed. Verify rule changes with fresh connections; established connections survive updates.
Treat server state, network reachability and application health as separate checks. Read the API action result and resource state back after changes; verify the intended service from its actual caller.
Gotchas worth retaining
- A recycled IP can trigger SSH's changed-host-key warning. Authenticate the
new fingerprint through a trusted console/channel before updating
known_hosts;
ssh-keyscanalone does not establish identity. - Servers and Primary IPs lost their
datacenterrequest/response property on 2026-07-01. The CLI's--datacenterflags onserver createandprimary-ip createare removed; use--location(or--assignee-idfor a Primary IP). The datacenter endpoints were removed on 2026-10-01, so the still-shippedhcloud datacenter list/describecommands fail with HTTP 410 Gone. Inspect the server type's per-location availability and prices withhcloud server-type describe <type> -o json. - Volumes are location-pinned; a server in another location cannot attach them. Private networks span locations within one network zone, not across zones.
- DNS zones do not take effect until the registrar delegates to the zone's
assigned nameservers. Before debugging records, read the Authoritative
Nameservers section of
hcloud zone describe <zone>(JSON:.authoritative_nameservers):delegation_statusshould bevalidanddelegatedshould matchassigned;delegation_last_checkshows how old that result is. - Deletion is immediate. Confirm resource IDs and the requested destructive scope; establish recoverable data first. Automatic backups are deleted with the server; snapshots survive. Create a Snapshot or convert a backup to one before deletion if recovery is required. Server snapshots/backups exclude attached Volumes, which need their own backup. See snapshot scope. Assigned Primary/Floating IPs cannot be deleted; unassign them first.
status: runningdoes not prove reachability. Inspecthcloud server describe <srv> -o json | jq '.public_net | {v4:.ipv4.blocked, v6:.ipv6.blocked}'for a provider block (abuse report or unpaid invoice) when several otherwise-open ports time out, SSH open to0.0.0.0/0included, or every server on the account fails at once. Such symptoms alone do not prove a block; a provider-level block needs Hetzner support, not an app firewall fix.firewall create/replace-rules --rules-filetakes a bare JSON array of rule objects (therulesvalue ofhcloud firewall describe <fw> -o json), not the API's{"rules": [...]}body, although the flag help points at the API schema.source_ips/destination_ipsare arrays of CIDR strings (203.0.113.4/32, not a bare IP) andportis a string ("22","80-85"). In PowerShell serialize withConvertTo-Json -InputObject @($rules) -Depth 5so a single rule stays an array. A parse or CIDR error rejects the whole file and leaves the previous rules in place; verify the returned/live rules.
Sources
- API changelog for renames and removals
- API reference
- Product documentation
- CLI manual/source
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |