---
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.
