ComposeFlux
A lightweight GitOps continuous deployment tool for Docker Compose.
ComposeFlux automates Docker Compose deployments using GitOps principles. It watches a Git repository, detects changes, and deploys the affected stacks without manual intervention.
ComposeFlux is in beta
Expect heavy refactoring and breaking changes as the project evolves toward v1.0. Progress is tracked in open v1.x.x issues.
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 with age |
| 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 |
New here? Start with the Overview, then follow Getting Started.