⚠️ 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.
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 |
| Change Detection | Git diff & dependency-tree detection deploys only affected stacks |
| Pure Go Implementation | Native Docker Compose SDK without shell execution |
| Offline Secrets (Age) | Encrypted *.age secret files in Git repos decrypted in-memory via passphrase |
| Remote Secrets Providers | 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 |
| Simple & Headless | No UI, no backend database |
Full Documentation — Getting started, configuration, guides, and more.
- 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.