V0.1 · Architecture & service documentation

THE SERVICE CATALOGUE

What runs here,
and what each part does.

32 guides cover the public scope of the lab. Open a service for its role, architecture, persistent data, operating checks and recovery considerations. Experiments and components needing revalidation are identified in their guides.

32 guides shown

Platform & networking↗

Proxmox VE

The virtualisation platform that runs the lab’s virtual machines.

Purpose · How it works · Data · Recovery →
Platform & networking↗

Docker & Compose

The application packaging and runtime used across the Linux service hosts.

Purpose · How it works · Data · Recovery →
Platform & networking↗

OPNsense

The routing and firewall layer that separates different kinds of lab traffic.

Purpose · How it works · Data · Recovery →
Platform & networking↗

Traefik

The reverse proxy that connects named HTTPS services to their application backends.

Purpose · How it works · Data · Recovery →
Platform & networking↗

BIND9

The authoritative DNS service for names managed inside the lab.

Purpose · How it works · Data · Recovery →
Platform & networking↗

AdGuard Home

DNS filtering and a view of resolver activity.

Purpose · How it works · Data · Recovery →
Platform & networking↗

UniFi Controller

The management application for supported UniFi networking equipment.

Purpose · How it works · Data · Recovery →
Platform & networking↗

phpIPAM

The address-management application used to organise network information.

Purpose · How it works · Data · Recovery →
Data & recovery↗

QNAP NAS & persistent storage

Shared storage used by selected applications and backup workflows.

Purpose · How it works · Data · Recovery →
Data & recovery↗

MySQL

A shared relational database service for applications that use MySQL.

Purpose · How it works · Data · Recovery →
Data & recovery↗

PostgreSQL

A shared relational database service supporting several application stacks.

Purpose · How it works · Data · Recovery →
Data & recovery↗

Redis

An in-memory data service used where applications need a cache or broker.

Purpose · How it works · Data · Recovery →
Data & recovery↗

Database administration tools

Adminer, pgAdmin, phpMyAdmin and RedisInsight provide operator interfaces.

Purpose · How it works · Data · Recovery →
Data & recovery↗

Proxmox Backup Server

The VM-backup platform, complemented by application-level recovery procedures.

Purpose · How it works · Data · Recovery →
Automation & operations↗

Ansible & Semaphore

The repeatable server baseline and the interface used to execute approved tasks.

Purpose · How it works · Data · Recovery →
Automation & operations↗

n8n

Workflow automation connecting incoming events to follow-up actions.

Purpose · How it works · Data · Recovery →
Automation & operations↗

Homepage

The internal start page that brings service links and selected summaries together.

Purpose · How it works · Data · Recovery →
Monitoring & logs↗

Zabbix

The primary monitoring platform for hosts, services and application endpoints.

Purpose · How it works · Data · Recovery →
Monitoring & logs↗

Elastic Stack & Fleet

The production log-search platform used to investigate events across servers and containers.

Purpose · How it works · Data · Recovery →
Monitoring & logs↗

Uptime Kuma

A secondary availability view intended to complement the main monitoring stack.

Purpose · How it works · Data · Recovery →
Monitoring & logs↗

Speedtest Tracker

Historical component · Revalidation needed

A service intended to record connectivity performance over time.

Purpose · How it works · Data · Recovery →
Applications↗

Paperless-ngx

Document intake, OCR, organisation and retrieval in a self-hosted application.

Purpose · How it works · Data · Recovery →
Applications↗

FreshRSS

A self-hosted RSS and Atom reader for news, security advisories and homelab topics.

Purpose · How it works · Data · Recovery →
Applications↗

Firefly III

A self-hosted finance application with an associated import workflow.

Purpose · How it works · Data · Recovery →
Applications↗

Vaultwarden

A self-hosted password-management application, described only at the architectural level.

Purpose · How it works · Data · Recovery →
Applications↗

Excalidraw

A browser-based drawing tool for explaining ideas and infrastructure relationships.

Purpose · How it works · Data · Recovery →
Applications↗

Public websites

Static websites built with Astro and published on Cloudflare.

Purpose · How it works · Data · Recovery →
Home automation↗

Home Assistant

The application that brings home-automation integrations and logic together.

Purpose · How it works · Data · Recovery →
Home automation↗

Mosquitto MQTT

The message broker used by the MQTT portion of home automation.

Purpose · How it works · Data · Recovery →
Home automation↗

Zigbee2MQTT

The bridge between Zigbee devices and the MQTT message layer.

Purpose · How it works · Data · Recovery →
Experiments↗

Floci & cloud-service experiments

A local service-emulation environment for cloud-related experiments.

Purpose · How it works · Data · Recovery →
Experiments↗

Kokoro TTS

A text-to-speech API used to explore a self-hosted inference service.

Purpose · How it works · Data · Recovery →