No description
  • Nix 71.8%
  • Shell 28%
  • Dockerfile 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-16 23:26:41 +01:00
.forgejo/workflows Clean up the remaining Paperless references 2026-11-07 21:55:07 +01:00
docs docs: rewrite for the Debian/Docker deployment; deploy from main 2026-11-16 23:26:41 +01:00
incus Forgejo runner: single 100G disk, host Nix runner, aggressive cleanup 2026-10-25 22:11:38 +01:00
nixos v2: scaffold Debian/Docker host, stacks, scripts and timers 2026-11-13 18:44:37 +01:00
scripts docs: rewrite for the Debian/Docker deployment; deploy from main 2026-11-16 23:26:41 +01:00
secrets secrets: add fluxer webhook and healthchecks endpoints 2026-11-16 23:21:10 +01:00
stacks wg-easy: allow plain HTTP for the LAN-only UI path 2026-11-15 20:55:28 +01:00
systemd renovate: run hourly 2026-11-13 21:13:42 +01:00
.gitattributes chore: fix file modes (remove exec bit from text files) 2026-08-18 16:51:25 +02:00
.gitignore fluxer: ship merged compose file for Dockge 2026-11-14 02:39:38 +01:00
.sops.yaml sops: enroll the reinstalled Debian host as a recipient 2026-11-15 00:02:10 +01:00
AGENTS.md docs: rewrite for the Debian/Docker deployment; deploy from main 2026-11-16 23:26:41 +01:00
PLAN.md v2: add migration runbook and data directory preparation 2026-11-13 18:46:23 +01:00
README.md docs: rewrite for the Debian/Docker deployment; deploy from main 2026-11-16 23:26:41 +01:00
renovate.json pvc-explorer: deploy the operator via upstream submodule + HelmRelease 2026-09-25 01:52:09 +02:00

HomeLab

Debian 13 + Docker Compose homelab. main is the current deployment.

The nixos/ and incus/ trees are the retired NixOS + Incus configuration. They are kept for reference only and are not deployed anywhere any more.

Layout

path purpose
stacks/ one Docker Compose stack per service
scripts/ bootstrap, deploy, backup, restore and secret rendering
systemd/ host units and timers
secrets/secrets.yaml sops/age encrypted secrets
docs/ operational notes and runbooks

Service data lives on bind mounts under /srv/docker/<service>. The restic repository lives on the SATA SSD under /srv/backup. The repository is checked out at /opt/homelab on the host; deploy.sh runs as root from there.

Host

  • Debian 13, btrfs root inside LUKS, unencrypted /boot.
  • NVMe: OS and live data (/srv/docker). SATA: LUKS + btrfs, /srv/backup.
  • Host SSH 2222. Initramfs dropbear 2223 (unlocks the root disk). Forgejo Git SSH 22.
  • Public services behind Caddy (80/443, Let's Encrypt via DNS-01).
  • WireGuard through wg-easy: 51820/udp, UI on 51821, tunnel 100.64.0.0/24 plus fd42:1::/64.
  • Split-horizon DNS on 192.168.178.200 (CoreDNS) for the admin names.

Services

stack reachable at
Forgejo forgejo.sakul-flee.de, SSH forgejo@…:22
Fluxer fluxer.sakul-flee.de
Website sakul-flee.de
Minecraft minecraft.sakul-flee.de:25565
Hytale hytale.sakul-flee.de:5520/udp
Admin (LAN/VPN only) dockge., vpn., syncthing., opencode.

First setup

On a fresh Debian 13 host:

sudo apt-get update && sudo apt-get install -y git
sudo git clone ssh://forgejo@forgejo.sakul-flee.de/SakulFlee/HomeLab.git /opt/homelab
sudo /opt/homelab/scripts/bootstrap.sh

Place the sops age identity at /etc/sops/age/keys.txt, then:

sudo /opt/homelab/scripts/render-secrets.sh
sudo /opt/homelab/scripts/deploy.sh --force

Normal operation

sudo /opt/homelab/scripts/deploy.sh     # pull, validate, deploy, health-check
sudo /opt/homelab/scripts/backup.sh     # dumps + restic + repo snapshot

deploy.sh is also driven by homelab-deploy.timer every 30 minutes. Push to main instead of rsyncing files: when the checkout is ahead of the remote, the timer treats that as a deploy and re-applies every stack on each run.

The off-box copy is pulled from Dendra, not pushed by the homelab. See docs/operations.md.

Secrets

Everything is encrypted with sops/age in secrets/secrets.yaml. The host keeps its identity at /etc/sops/age/keys.txt; scripts/sops.sh is a wrapper that uses it. Store the age key and the restic repository passwords offline.

The Forgejo SECRET_KEY must never be regenerated on an existing database. It decrypts 2FA secrets and other encrypted rows; rotating it silently breaks every account that has 2FA enabled.

Documentation

  • docs/operations.md — deployment, backups, alerting, VPN/DNS, and the known sharp edges. Start here.
  • docs/ssh.md — host SSH, Forgejo SSH and initramfs unlock.
  • docs/secrets.md — sops layout and how to read a value.
  • docs/restore.md — restoring and inspecting backups.
  • docs/staging.md — running the stacks off-production.
  • PLAN.md, docs/migration.md, docs/incus-export.md — the historical migration from NixOS + Incus. Kept for provenance, no longer current.