No description
  • Python 96.9%
  • Dockerfile 3.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
John Sturgeon bfab087907 fruitdeeplinks: add /replay endpoint for finished games
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 06:59:06 +01:00
.forgejo/workflows updated 2026-08-01 21:19:59 +02:00
.run fixed sync pihole dns 2026-07-17 15:24:33 +02:00
adb-tuner Adding docker compose for adb-tuner 2026-02-14 21:27:09 +01:00
audiobookshelf-metadata Added audiobookshelf 2026-08-02 16:11:51 +02:00
channels-mlb Updated to support external volume 2026-07-15 11:27:10 +02:00
eplustv added eplustv 2026-07-12 21:29:42 +02:00
fastchannels readded tz 2026-07-15 21:51:33 +02:00
freshrss Set FreshRSS's time zone to Europe/Paris 2026-11-03 20:55:20 +01:00
fruitdeeplinks fruitdeeplinks: add /replay endpoint for finished games 2026-11-11 06:59:06 +01:00
homelab-dashboard Give homelab-dashboard Komodo access 2026-11-01 19:55:41 +01:00
homelab-utils/ha-presence-simulator cleaned up paths on the docker compose for HA Presence Simulation 2026-03-02 09:58:39 -08:00
kestra moved docker to komodo deployable area 2026-07-09 09:26:03 +02:00
kestra-ns-files Give the Minecraft flow's SSH username as an expression 2026-11-03 20:23:43 +01:00
op-python-base Bake uptime-kuma-api, pyjwt and cryptography into op-python-base 2026-10-26 09:18:39 +01:00
pangolin Fixed error with pangolin 2026-07-08 19:15:02 +02:00
paperless Move the Paperless stack to Komodo 2026-11-05 20:14:00 +01:00
registry renamed yaml 2026-07-17 12:33:33 +02:00
tgfp Added tgfp to the stack 2026-08-14 21:09:42 +02:00
tidarr Fixed tidarr permissions for group write of files 2026-06-25 11:42:01 +02:00
tindra Added the PUBLIC_URL variable to Tindra 2026-08-14 15:11:47 +02:00
.gitignore fixed sync pihole dns 2026-07-17 15:24:33 +02:00
a touched a 2026-07-22 17:14:33 +02:00
README.md Document the three deploy triggers in the root README 2026-10-26 09:30:16 +01:00

homelab-stacks

Docker Compose stacks for my homelab, managed via Komodo with GitOps auto-sync.

Note: Migrated from Dockhand to Komodo.

Structure

Each stack lives in its own directory with a docker-compose.yml and optional .env file:

stack-name/
  docker-compose.yml
  .env (if needed)

Deployment

Stacks are deployed to remote Docker hosts via Komodo + Periphery agents over Tailscale. Komodo syncs from this repo and manages the full lifecycle — deploy, update, rollback.

Deploy triggers

Three independent paths. Everything here is driven by a push to main — nothing in this repo is triggered by tagging a release. (The tag-triggered image builds are in the application repos, like tgfp-web. The v1.x tags on this repo are leftovers and fire nothing.)

What Trigger Mechanism
Compose stacks Push touching the stack's directory Komodo polls this repo and redeploys the affected stacks
Kestra flows and namespace files Push touching kestra-ns-files/** Forgejo webhook fires system/tenant_sync, which runs TenantSync with sourceOfTruth: GIT
op-python-base image Push touching op-python-base/** .forgejo/workflows/build-op-python-base.yml builds on the self-hosted runner and pushes :latest to the registry

Publishing a new op-python-base image

Commit the change under op-python-base/ and push to main:

git add op-python-base
git commit -m "..."
git push origin main

The Forgejo action logs into 192.168.192.129:3000, builds and pushes :latest. Every Kestra task runs pullPolicy: ALWAYS, so the next execution pulls it — nothing to copy onto a host. Watch the run under Actions in Forgejo; the image is live once it goes green.

Two things worth knowing:

  • The path filter is the only trigger. There's no manual re-run button configured, so a rebuild with no change under op-python-base/ (to pick up a newer python:3.13-slim or uv, say) has nothing to fire it.
  • A flow needing a new package must be pushed after that build is green, because the Kestra webhook and the image build watch different paths and finish at very different times. See kestra-ns-files/README.md.

Hosts

Stacks are distributed across multiple Proxmox LXC containers, each running Docker with a Periphery agent. Host assignments are configured in Komodo's server settings, not in this repo.

Notes

  • All volume paths use absolute paths (required for Periphery remote deployment)
  • Sensitive values go in Komodo's variable/secret management, not committed here
  • Komodo polls this repo for changes; pushes trigger redeployment of affected stacks
  • Kestra gets a push webhook; Komodo polls — see Deploy triggers