homelab-docs/CLAUDE.md

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 - Infrastructure components, network topology, WireGuard VPN
• .claude/docs/SERVICES.md - Deployed services, container IDs, service-specific details
• .claude/docs/SCRIPTS.md - Deployment scripts and automation tools

Operations

• .claude/docs/COMMON-TASKS.md - SSH access, Caddy management, container operations
• .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