Technical Documentation

Single-VM platform documentation without framework noise.

This site documents the `genesis` platform behind `shellr.net`: runtime boundaries, routing, deployment flow, monitoring, logging, and backup on a single Hetzner VM. The aim is clarity, not volume.

Hetzner VM Docker Compose Nginx GitHub Pages

Platform Summary

Hostnames and runtime boundaries

Hostname Purpose Target
shellr.net Personal landing page and frontdoor Portfolio app container
dma.shellr.net DMA application DMA PHP container
grafana.shellr.net Metrics and logs UI Grafana behind Nginx auth
status.shellr.net Uptime surface Uptime Kuma
docs.shellr.net Static documentation GitHub Pages

Projects

Overview of the main platform and the DMA application, including how they are positioned operationally.

Read more

Architecture

Topology, routing model, and deployment boundaries for the single-VM platform.

Read more

Monitoring and Logging

How visibility is implemented without turning the VM into an observability cluster.

Read more

Backup

What is backed up, how rotation works, and how restore stays understandable.

Read more

Lessons Learned

Operational decisions that changed after integrating real services on a small host.

Read more

Source of truth

The repo contains the same material as markdown under /docs for review and versioning.

Open markdown index