Files

Hermes Agent e4d91aadf9 Initial commit: homelab infrastructure wiki

- Full Obsidian vault content
- Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte)
- Media stack documentation
- Traefik HA setup
- Automation scripts
- Bachelor party planning

2026-05-24 16:08:40 -07:00

2.1 KiB

Raw Blame History

title, created, updated, type, tags, sources

title

created

updated

type

GitOps

The homelab uses a GitOps pattern where the git repository IS the infrastructure.

Core Principle

All configuration lives in /home/bear/homelabagentroot/. Each host pulls its configs from the repo. Agents (Hermes, OpenCode) commit changes and push to Gitea. Other hosts pull on next session.

Repository Structure

homelabagentroot/
├── homelab/           # Infrastructure configs per host
│   ├── ubuntu/         # Docker Compose, configs
│   ├── grizzley/      # RPi5 edge configs
│   ├── ice/           # Control plane configs
│   └── proxmox/       # VM/LXC configs
├── scripts/           # Shared automation
├── ansible/           # Playbooks for deployment
├── obsidian-vault/    # Wiki (IS the vault)
└── .opencode/         # OpenCode agent config

Git Triggers

Action	What Happens
Agent commits & pushes	Configs pushed to Gitea
Other host pulls	Gets latest configs
Drift detected	`detect-drift.py` or `drift_detector.py` flags differences
Manual deploy	`ansible-playbook deploy-services.yml --limit <host>`

Agents Using GitOps

Agent	Host	Role
Hermes	ice, grizzley	Commit infra changes, push to Gitea
OpenCode	ubuntu, ice	Read/write configs, run Ansible
Gitea	ubuntu	GitOps hub — all repos live here

Key Files

scripts/homelab/deploy-service.py — Deploy services to remote hosts
scripts/homelab/detect-drift.py — Detect config drift between repo and hosts
ansible/playbooks/deploy-services.yml — Restart Docker services
ansible/playbooks/sync-configs.yml — Pull/push docker-compose configs

gitea — Git host and GitOps runner hub
ubuntu — Primary Docker host where most configs deploy
ice — Control plane, primary Hermes Agent host
deployment-scripts — Full automation scripts inventory

2.1 KiB Raw Blame History