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.
| 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 |
- 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)
See the Development Guide for build instructions and project layout.
MIT. See LICENSE.