⚠️ Currently in beta
A GitOps continuous deployment tool for Docker Compose
ComposeFlux automates Docker Compose deployments using GitOps principles. Monitor your Git repository, detect changes, and automatically deploy your Docker stacks—all without manual intervention.
| Feature | Description |
|---|---|
| GitOps Driven | Automatic deployment from Git repository |
| Smart Change Detection | Hash-based detection deploys only changed stacks |
| Pure Go Implementation | Native Docker Compose SDK without shell execution |
| Secrets Management | Optional Bitwarden Secrets Manager and Infisical support |
| Automatic Image Updates | Scheduled registry checks redeploy stacks when newer images are available |
| Flexible Configuration | Startup order and shared environment variables |
| Prometheus Metrics | Built-in metrics endpoint for deployment, image update, and prune observability |
| Simple & Headless | No UI, no backend database |
- 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)
Contributions are welcome! Please see our Development Guide for details.
This project is licensed under the MIT License - see the LICENSE file for details.