Initial infrastructure documentation - comprehensive homelab reference

2026-02-23 03:42:22 +00:00
commit 0682c79580
169 changed files with 63913 additions and 0 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,59 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Quick Reference
+
+This repository manages Fred's homelab infrastructure - a mix of deployment scripts, monitoring tools, and service integrations for a Proxmox-based network.
+
+**When you need specific information, refer to these specialized docs:**
+
+### Core Architecture
+
+- [.claude/docs/ARCHITECTURE.md](.claude/docs/ARCHITECTURE.md) - Infrastructure components, network topology, WireGuard VPN
+- [.claude/docs/SERVICES.md](.claude/docs/SERVICES.md) - Deployed services, container IDs, service-specific details
+- [.claude/docs/SCRIPTS.md](.claude/docs/SCRIPTS.md) - Deployment scripts and automation tools
+
+### Operations
+
+- [.claude/docs/COMMON-TASKS.md](.claude/docs/COMMON-TASKS.md) - SSH access, Caddy management, container operations
+- [.claude/docs/CERTIFICATES.md](.claude/docs/CERTIFICATES.md) - Step-CA setup, ACME provisioner, SSL configuration
+
+### Detailed References (load when needed)
+
+- Subdirectories have their own CLAUDE.md files (infrastructure/, n8n-workflows/, etc.)
+- Service-specific deployment guides in respective directories
+- Submodule documentation in submodule directories
+
+## Essential Quick Facts
+
+**Primary Infrastructure:**
+
+- VPS: fred@66.63.182.168 (vps.nianticbooks.com) - Caddy reverse proxy
+- Proxmox: root@10.0.10.3 (main-pve) - LXC container host
+- Network: 10.0.10.0/24 (WireGuard tunnel: 10.0.8.0/24)
+
+**Critical Services:**
+
+- Uptime Kuma: 10.0.10.26 (CT 128)
+- Home Assistant: 10.0.10.24
+- CA Server: 10.0.10.15 (CT 115)
+
+## Repository Structure
+
+**Subdirectories:**
+
+- `infrastructure/` - Core infrastructure docs and automation
+- `n8n-workflows/` - n8n workflow JSON definitions
+- `bible-reading-plan/` - Submodule (separate repo)
+
+**Slash Commands:**
+
+- `/eod`, `/push`, `/focus`, `/sidequest`, `/stuck`, `/reflect` (in `.claude/commands/`)
+
+## Key Constraints
+
+- Proxmox storage: `local` only (never `local-lvm`)
+- SSH: Always use key-based auth
+- Test on target system before committing
+- VPS: 2 CPU / 4GB RAM - lightweight services only