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 www repository 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

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.