ComposeFlux

A lightweight GitOps continuous deployment tool for Docker Compose.

Overview • Getting Started • Development • Releases

Currently in beta. Expect heavy refactoring and breaking changes as the project evolves toward v1.0. See open v1.x.x issues for tracking progress toward the first stable release.

ComposeFlux automates Docker Compose deployments using GitOps principles. It watches a Git repository, detects changes, and deploys the affected Docker stacks without manual intervention.

---

Features

Feature	Description
GitOps driven	Deployments follow the Git repository
Change detection	Only stacks affected by a commit are redeployed
Lightweight and headless	Single container, no UI, no database, no control plane
Pure Go implementation	Native Docker Compose SDK, no shell execution
Offline secrets	*.age files in the repository are decrypted in memory
Remote secrets	Optional Bitwarden Secrets Manager and Infisical support
Automatic image updates	Scheduled registry checks redeploy stacks when newer images are available
Flexible configuration	Deployment order and shared environment variables

Blog Posts

• GitOps for Homeservers (Part 1) - My Homeservers, Ansible, and the Pain Points
• GitOps for Homeservers (Part 2) — Searching for the Right Tool
• GitOps for Homeservers (Part 3) — ComposeFlux: A Lightweight GitOps Tool
• How I Manage My Homeservers with GitOps and Docker Compose (Medium)

Contributing

See the Development Guide for build instructions and project layout.

License

MIT. See LICENSE.