Skip to content

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.