Skip to content
Khaled.dev
← Back to work

Solo engineer — infrastructure, packaging, docs · 2024

OpenHuman Self-Host

A reproducible, single-command self-hosted deployment of the OpenHuman stack with backups, TLS, and observability baked in.

OpenHuman Self-Host

Stack

  • Docker Compose
  • Caddy
  • PostgreSQL
  • Prometheus
  • Grafana
  • Bash

Links

Overview

What it is

OpenHuman is great but the official deploy story assumes a managed cloud. This project packages the whole stack — app, database, object store, and reverse proxy — into a single declarative compose setup that runs on a $5 VPS or a homelab box.

It ships with automated encrypted off-site backups, Let's Encrypt TLS renewal, and a Grafana/Prometheus pair wired to the app's metrics endpoint. A teardown script makes it disposable for testing.

Highlights

4 things worth calling out

Single-command deploy on a $5 VPS

Encrypted off-site backups on a schedule

Automatic TLS via Caddy + Let's Encrypt

Bundled Prometheus + Grafana observability