setting-up-hetzner

What problem does it solve?

This Skill provides a guided, repeatable process to configure Hetzner cloud access for a new development workstation, eliminating manual setup and token misconfigurations.

Core Features & Use Cases

• Guided onboarding for setting up the Hetzner hcloud CLI context.
• Seamless direnv integration to load HCLOUD_TOKEN and keep environments isolated.
• Verified setup workflow including token retrieval prompts and SSH-key readiness.
• Use Case: A new developer can bootstrap their workstation in minutes, enabling immediate cloud operations and server management.

Quick Start

Step 1: Install prerequisites (hcloud, direnv, nix) if not already installed. Step 2: Create hcloud context

• Run: hcloud context create workstation
• Enter your API token when prompted
• Get token from: https://console.hetzner.cloud → Project → Access → API Tokens → Generate (Read & Write) Step 3: Allow direnv
• Navigate to your project directory
• Run: direnv allow This loads HCLOUD_TOKEN from your hcloud CLI context. Step 4: Verify setup
• Run: echo $HCLOUD_TOKEN | head -c 10
• Run: hcloud server list Step 5: SSH Key Setup
• Run: hcloud ssh-key list
• If 'devbox' key is missing: hcloud ssh-key create --name devbox --public-key-from-file ~/.ssh/id_ed25519.pub