Files

dtoro 41fe34a3c3 migrate: Booklore → Grimmory on new LXC 130

Grimmory (grimmory-tools/grimmory) is the community fork/successor of
Booklore. Moving it off the shared apps LXC (105) onto a dedicated
container (130, 192.168.8.213) to avoid the Portainer-managed stack
footgun that wiped mariadb in April.

- containers/130-grimmory.md: new container doc with compose layout,
  Authentik OIDC notes (PKCE/Public client), media-GID setup
- plans/2026-06-29-grimmory-migration.md: step-by-step runbook for
  DB dump/restore, LXC provisioning, Caddy cutover, Authentik update
- inventory.yaml: add grimmory LXC 130
- containers/105-apps.md: remove Booklore section + hostname entry
- containers/index.md: update 105 row; add 130 row
- infrastructure/media-permissions.md: add LXC 130; update Booklore→Grimmory refs
- README.md: update 105 row; add 130 row

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-29 01:11:00 +02:00

4.8 KiB

Raw Blame History

Homelab Wiki — `hubris`

Living documentation for the hubris Proxmox homelab. Every node, every cross-cutting system, and every meaningful incident is its own page; pages are linked so you can start anywhere and walk the graph.

Last refreshed against live state: 2026-04-28.

Map

Hosts

hubris — single Proxmox VE node, GMKtec NucBox M6 Ultra, 192.168.8.77

VMs

100 — zimaos — ZimaOS 1.6.1, NAS frontend (evaluation)
108 — haos-16.3 — Home Assistant OS

LXC containers

See the full table in containers/index.md. Quick links:

ID	Name	IP	Role
101	jellyfin	192.168.8.206	Media server
102	nfs-export	192.168.8.200	NFSv4 re-export of /mnt/library for ZimaOS
103	paperless	192.168.8.130	Document mgmt
104	gitea	192.168.8.121	Git server
105	apps	192.168.8.205	Docker host (Artifacto / PlantUML / Portainer / WriteFreely)
114	nextcloud	192.168.8.224	Personal cloud
118	elementsynapse	192.168.8.239	Matrix Synapse
119	sophia	192.168.8.157	Sophia
120	mule-images	192.168.8.136	Mule-image / mulita photos
121	caddy	192.168.8.175	Reverse proxy
122	arriman	192.168.8.132	Docker host (*arr stack)
124	authentik	192.168.8.180	SSO + split-horizon DNS
130	grimmory	192.168.8.213	Digital library (Grimmory — fork of Booklore)

Cross-cutting infrastructure

DNS — split-horizon
Ingress — Caddy + VPS traefik
Mesh — Tailscale → Netbird migration
Monitoring — Hermes health watchdog
Media permissions — media GID 10000
SSH access
Backups — restic on external drive (disabled)
Auto-deploy — gitea-webhook pipelines
VPS hardening — IONOS / netbird control plane
Homelab context distribution — cross-client /opt/homelab-context + MCP + secrets-issuance

Investigations

Time-stamped incident notes / experiments in investigations/.

Operations

Command cheatsheet
Agent enrollment — bootstrap a new client (workstation, LXC, VM) into the homelab context system

Conventions

Each node page ends with a ## Changelog section. Reverse-chronological. Entry format:
```
### YYYY-MM-DD — short title
one or two lines on what changed and why.
```
Cross-linking is mandatory. If a page references another node or system, link to it. Treat orphans as a bug.
Live state wins. When something here disagrees with pct config / docker inspect / running config, fix the wiki and note the change in the relevant changelog.
Tracked configs. A node whose config lives in a Gitea repo (Caddy, Gitea customizations, Artifacto, mule-image) is auto-deployed via webhook — see auto-deploy. Edits there must be pushed, not left local.
No secrets. This is a private repo on git.hubris.network, but still: paths to secret files are fine, secret values are not.

Maintaining this wiki

When you change a node:

Update the relevant page (config snapshot, ports, mounts).
Add a changelog entry at the bottom of that page.
If the change touches a cross-cutting system (DNS, Caddy, Authentik, mesh), update that page too and link it from the changelog entry.
If it's an incident, add an entry to investigations/.

4.8 KiB Raw Blame History

Homelab Wiki — hubris

Map