60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# 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
|