skills.rest
fcakyon
fcakyonCOMMUNITY
Explore all skills by this author →
Website𝕏@fcakyonGitHub

hetzner-deploy

Provision and manage Hetzner Cloud infrastructure using the hcloud CLI.

1.1k|107|Updated Jul 9, 2025
Search Tags:#CLI#server provisioning#dns#Hetzner#hcloud#Cloud Infrastructure#devOps
One-click install
npx skills add https://github.com/fcakyon/claude-codex-settings --skill hetzner-deploy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hetzner-deploy
Source: https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/hetzner-skills/skills/hetzner-deploy
Command: npx skills add https://github.com/fcakyon/claude-codex-settings --skill hetzner-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing Hetzner Cloud resources requires memorizing dozens of hcloud CLI commands, flags, and workflows. This Skill provides decision trees, ready-to-run command patterns, and full CLI reference documentation so an AI agent can provision servers, networks, firewalls, load balancers, volumes, and DNS zones correctly on the first attempt.

Core Features & Use Cases

  • Decision Trees for Every Resource: Quick lookup trees map intents like "I need compute" or "I need DNS" directly to the correct hcloud command group and flags.
  • Complete CLI Reference: Bundled reference docs cover servers, networks, firewalls, load balancers, floating IPs, volumes, storage boxes, DNS zones, SSH keys, certificates, images, and placement groups.
  • Scriptable Output: Guidance on JSON, YAML, Go template, and column output formats for automation and agent-driven workflows.
  • Use Case: Ask the agent to deploy a production web stack, and it will create a private network, firewall rules, a server with SSH key access, and a load balancer using the documented multi-step workflow.

Quick Start

Ask the agent to create a Hetzner Cloud server named web-1 of type cpx21 running Ubuntu 24.04 in the fsn1 location with your SSH key attached.

Frequently Asked Questions about hetzner-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Hetzner Cloud server with the hcloud CLI?▼

Run hcloud server create with --name, --type, --image, and optionally --ssh-key, --location, --network, and --firewall flags. For example: hcloud server create --name web-1 --type cpx21 --image ubuntu-24.04 --ssh-key deploy-key --location fsn1.

How to authenticate the hcloud CLI with Hetzner Cloud?▼

Set the HCLOUD_TOKEN environment variable for stateless use in CI or scripts, or run hcloud context create <name> for interactive named contexts. Generate API tokens in the Hetzner Cloud Console under your project's Security > API Tokens section.

Can hcloud manage DNS zones and records?▼

Yes, the hcloud zone command group manages DNS zones and RRSets. You can create zones, add or set records, import and export BIND zone files, change TTLs, and manage individual rrsets with commands like hcloud zone add-records.

How do I get JSON output from hcloud commands?▼

All describe, list, and create commands support the --output flag with json, yaml, format (Go templates), or columns options. For example, hcloud server list --output json returns a JSON array suitable for scripting.

Does hcloud support firewalls and private networks?▼

Yes, hcloud firewall creates firewalls from JSON rule files and applies them to servers, while hcloud network creates private VPC networks with subnets. Both can be attached at server creation time via --firewall and --network flags.

What are the limitations of hcloud storage boxes?▼

Storage Box type downgrades are rejected when the target type offers less disk space than currently used. Snapshot plans, subaccounts, and access settings (Samba, SSH, WebDAV) must be configured explicitly at creation or via update commands.

Related Skills

Explore More Software Engineering Skills→
johnnymo87johnnymo87
4

setting-up-hetzner

Configure Hetzner hcloud context with direnv token loading and SSH-key verification.

Community
Advanced
BrownbullBrownbull

devops-orchestrator

Automate infrastructure provisioning, CI/CD pipelines, and deployments across cloud environments.

Community
Advanced
tomztomz

do-compute

Automate DigitalOcean Droplet, volume, and networking resource management.

Community
Advanced
zangxin75zangxin75

hetzner-provisioner

Generate Terraform or Pulumi code for Hetzner Cloud servers and databases.

Community
Advanced