hetzner-provisioner

# Hetzner Cloud Provisioner

Automated infrastructure provisioning for Hetzner Cloud - the budget-friendly alternative to Vercel and AWS.

## Purpose

Generate and deploy infrastructure-as-code (Terraform/Pulumi) for Hetzner Cloud, enabling $10-15/month SaaS deployments instead of $50-100/month on other platforms.

## When to Use

Activates when user mentions:
- "deploy on Hetzner"
- "Hetzner Cloud"
- "budget deployment"
- "cheap hosting"
- "deploy for $10/month"
- "cost-effective infrastructure"

## What It Does

1. **Analyzes requirements**:
   - Application type (NextJS, Node.js, Python, etc.)
   - Database needs (Postgres, MySQL, Redis)
   - Expected traffic/users
   - Budget constraints

2. **Generates Infrastructure-as-Code**:
   - Terraform configuration for Hetzner Cloud
   - Alternative: Pulumi for TypeScript-native IaC
   - Server instances (CX11, CX21, CX31)
   - Managed databases (Postgres, MySQL)
   - Object storage (if needed)
   - Networking (firewall rules, floating IPs)

3. **Configures Production Setup**:
   - Docker containerization
   - SSL certificates (Let's Encrypt)
   - DNS configuration (Cloudflare or Hetzner DNS)
   - GitHub Actions CI/CD pipeline
   - Monitoring (Uptime Kuma, self-hosted)
   - Automated backups

4. **Outputs Deployment Guide**:
   - Step-by-step deployment instructions
   - Cost breakdown
   - Monitoring URLs
   - Troubleshooting guide

---

## ⚠️ CRITICAL: Secrets Required (MANDATORY CHECK)

**BEFORE generating Terraform/Pulumi code, CHECK for Hetzner API token.**

### Step 1: Check If Token Exists

```bash
# Check .env file
if [ -f .env ] && grep -q "HETZNER_API_TOKEN" .env; then
  echo "✅ Hetzner API token found"
else
  # Token NOT found - STOP and prompt user
fi
```

### Step 2: If Token Missing, STOP and Show This Message

```
🔐 **Hetzner API Token Required**

I need your Hetzner API token to provision infrastructure.

**How to get it**:
1. Go to: https://console.hetzner.cloud/
2. Click on your project (or create one