49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
---
|
|
type: hub
|
|
title: servers — homelab and production infrastructure umbrella
|
|
summary: Navigation hub for the `servers` repo, a consolidated umbrella of independent infrastructure projects (desktop Hyprland migration, home Proxmox VMs, and the OVHcloud production VPS) each with its own scope and safety rules.
|
|
tags:
|
|
- type/hub
|
|
- project/servers
|
|
- domain/infrastructure
|
|
- tool/proxmox
|
|
- tool/docker
|
|
scope: project
|
|
last_updated: 2026-07-13
|
|
date: 2026-07-13
|
|
source: servers
|
|
---
|
|
|
|
# servers
|
|
|
|
`/home/jared/servers` is a consolidated umbrella directory for infrastructure projects, each
|
|
scoped as its own Claude Code project with its own `CLAUDE.md`. Full operational detail (host
|
|
facts, safety rules, service inventories, setup checklists) lives in each subdirectory's
|
|
`CLAUDE.md` and docs — this note is a cross-session pointer, not a duplicate.
|
|
|
|
## Subprojects
|
|
|
|
- `desktop/` — Fedora 43 local machine: GNOME → Hyprland window-manager migration
|
|
(Phase 4 in progress) + backup/monitoring infra (n8n, Ruby scripts).
|
|
- `proxmox-hermes/` — self-hosted Hermes AI agent (Nous Research) on VM 102 (hermes01),
|
|
home Proxmox host `pve`.
|
|
- `proxmox-home-assistant/` — Home Assistant OS (HAOS) on VM 103 (haos01), same host.
|
|
- `proxmox-ubuntu/` — Ubuntu VM 101 (ubuntu-server): Pi-hole (LAN DNS) today; future
|
|
services follow the ovh-prod pattern.
|
|
- `ovh-prod/` — production OVHcloud VPS (systems-prod-01): Docker/Traefik reverse proxy
|
|
hosting WordPress, Rails apps, n8n, Vaultwarden, and other services.
|
|
|
|
## Shared context
|
|
|
|
- Proxmox host `pve` (192.168.86.97:8006) is shared infrastructure for the three
|
|
`proxmox-*` subprojects — host facts, VM inventory, and safety rules (never touch VM 100,
|
|
scoped API token only, no host shell) are inlined in the umbrella `CLAUDE.md` since
|
|
Claude Code's `@../` imports don't resolve across sibling directories.
|
|
- Server skill PRD (`ovh-prod/docs/prd-server-skill.md`) is the standing direction for how
|
|
Docker-hosted services should be installed/managed across every project in this umbrella.
|
|
|
|
## Related
|
|
|
|
- [[cc-os-hub]] — the personal cross-project tooling (os-adr, os-vault, os-backlog) used to
|
|
manage this and other repos.
|