Homelab

Let Renovate open update PRs for your Docker Compose homelab

Keep compose files in Git, pin versions, and let Renovate propose each update as a pull request with release notes attached.

2026-10-29
Illustration: Let Renovate open update PRs for your Docker Compose homelab
Original illustration by SafeToUpdate (CC BY 4.0).

Once your image tags are pinned (why), the next problem is noticing new versions. Renovate solves that: it scans your repo and opens a pull request for each available update.

1. Put your stacks in Git

One repo with a folder per stack (immich/compose.yaml, vaultwarden/compose.yaml, …). Keep secrets out of Git and in ignored .env files.

2. Enable Renovate

Use the Renovate app on GitHub or self-host Renovate for Gitea/Forgejo. Renovate’s Docker Compose manager detects image: lines in compose files automatically.

Minimal renovate.json:

{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended"]
}

3. Tune it for a homelab

4. Review like a sysadmin

Each PR links release notes when Renovate can find them. Read them (or check the SafeToUpdate verdict), merge, then on the host:

git pull && docker compose pull && docker compose up -d

Checklist

📬 The Weekend Patch Report

One email a week: what's safe to update, what will bite, and one practical tip for your homelab or printer.

Free, weekly, unsubscribe anytime.