Context
kuhree.com is both this selectively public notebook and the self-hosted platform behind it. It is a working testbed for reproducible infrastructure, service operations, observability, and the tools I use every day.
Goals
- Operate reliable self-hosted services for daily use.
- Maintain reproducible infrastructure and service lifecycle workflows.
- Continue consolidating service operations and observability.
Implementation
Stack
- Quartz and Markdown for the public notebook
- NixOS for hosts and reproducible system configuration
- kuhree.com/platform for deploys and service operations
- OpenTelemetry, VictoriaMetrics/Logs/Traces, and Grafana for observability
- Served from a small VPS so the site stays up when the home lab is down
Architecture / Integrations
- The
wwwrepository owns this site and its publication boundary; its CI builds each release, and platform serves a pinned version - kuhree.com/platform owns host inventory, service definitions, deploy workflows, and operational checks
- Public content is explicitly selected with
publish: true; private notes and unreviewed media never enter the site artifact
Repos / URLs
- Domain: https://kuhree.com
- Site repo: https://git.kuhree.com/kuhree.com/www
- Infrastructure repo: https://git.kuhree.com/kuhree.com/platform
Status
Active. The website and the underlying platform continue to evolve together, while remaining separate deployment concerns.
Lessons
- Service sprawl grows quickly; maintain one canonical status inventory.
- Keep network diagrams current to reduce operational drift.
- Prefer explicit runbooks for pull/up/down/log/exec workflows.
Notes
- Existing command snippets remain useful for routine operations and should be retained in supporting docs.
- Sensitive host/network credentials and internal topology details are not published here.
