https://github.com/veerendra2/composeflux

A GitOps continuous deployment tool for Docker Compose
https://github.com/veerendra2/composeflux

compose-sdk docker docker-compose docker-sdk-go gitops

Last synced: 3 months ago
JSON representation

A GitOps continuous deployment tool for Docker Compose

• Host: GitHub
• URL: https://github.com/veerendra2/composeflux
• Owner: veerendra2
• License: mit
• Created: 2026-02-20T09:02:54.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-03-29T12:35:42.000Z (3 months ago)
• Last Synced: 2026-03-29T15:30:46.086Z (3 months ago)
• Topics: compose-sdk, docker, docker-compose, docker-sdk-go, gitops
• Language: Go
• Homepage: https://veerendra2.github.io/composeflux/
• Size: 1.89 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
![GitHub Repo stars](https://img.shields.io/github/stars/veerendra2/composeflux) ![GitHub forks](https://img.shields.io/github/forks/veerendra2/composeflux) ![GitHub License](https://img.shields.io/github/license/veerendra2/composeflux) ![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/veerendra2/composeflux)

# ComposeFlux

> :warning: _Currently in beta_

_A GitOps continuous deployment tool for Docker Compose_

![ComposeFlux](./docs/assets/composeflux-banner.png)

ComposeFlux automates Docker Compose deployments using GitOps principles. Monitor your Git repository, detect changes, and automatically deploy your Docker stacks—all without manual intervention.

---

## Features

- **GitOps Driven** - Automatic deployment from Git repository

- **Smart Change Detection** - Hash-based detection deploys only changed stacks

- **Pure Go Implementation** - Native Docker [Compose SDK](https://docs.docker.com/compose/compose-sdk/) without shell execution

- **Secrets Management** - Integrated 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

## Documentation

- 📖 [**Introduction**](https://veerendra2.github.io/composeflux/Introduction/)

- 🚀 [**Getting Started**](https://veerendra2.github.io/composeflux/GettingStarted/)

## Contributing

Contributions are welcome! Please see our [Development Guide](https://veerendra2.github.io/composeflux/Development/) for details.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.