docs: self-hosting guide #32

New issue

Closed

opened 2026-03-23 03:53:44 +00:00 by barrettruth · 0 comments

barrettruth commented

2026-03-23 03:53:44 +00:00

Problem

No documentation exists for deploying delta on a new machine. Currently only Barrett knows the NixOS module setup.

Scope

NixOS module configuration (systemd service, nginx reverse proxy, SSL)
Required env vars (DATABASE_URL, AUTH_SECRET, OAuth client IDs if enabled)
SQLite database location and backup strategy
R2/S3 backup cron setup
DNS configuration
First-user creation (seed script or registration flow)
Docker alternative for non-NixOS hosts

## Problem No documentation exists for deploying delta on a new machine. Currently only Barrett knows the NixOS module setup. ## Scope - NixOS module configuration (systemd service, nginx reverse proxy, SSL) - Required env vars (`DATABASE_URL`, `AUTH_SECRET`, OAuth client IDs if enabled) - SQLite database location and backup strategy - R2/S3 backup cron setup - DNS configuration - First-user creation (seed script or registration flow) - Docker alternative for non-NixOS hosts