Claude Code Instructions for hummel.casa Terraform Infrastructure

This repository manages Proxmox LXC guests using Terraform for the hummel.casa homelab infrastructure.

Primary Workflow: Adding New LXC Guests

Prerequisites (Manual Steps Outside Repository)

1. Reserve MAC Address: Get next virtual MAC address from MAC address table in Notion doc (format: 0A:BC:DE:00:00:XX)
2. Reserve IP Address: Get next private IP in homelab CIDR range (10.20.71.XXX) from Notion doc
3. Create DHCP Reservation: Add MAC/IP pair to Unifi controller
4. Plan Application: Select docker image/tag and subdomain (e.g., my-app -> my-app.hummel.casa)
5. Create Ansible Playbook: Add playbook to ansible repository at https://gitea.hummel.casa/hummel.casa/ansible

Repository Structure

• main.tf: Core infrastructure with locals.guests definitions and shared resources
• Individual {guest-name}.tf files: Each guest has its own file with random_password, proxmox_lxc, and cloudflare_record resources
• setup-ansible-pull-cron.sh: Provisioner script that configures new guests

Steps to Add New Guest