Bosun
GitOps for Docker Compose. No Kubernetes required.
Push to git. Bosun receives orders. Containers deploy. Smooth sailing.
┌──────────┐ ┌───────────────────────┐ ┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌───────────────────┐ ┌────────────────────┐
│ git push ├────►│ Bosun receives orders ├────►│ Clone & decrypt ├────►│ Template configs ├────►│ Deploy to target ├────►│ docker compose up ├────►│ Drift verification │
└──────────┘ └───────────────────────┘ └─────────────────┘ └──────────────────┘ └──────────────────┘ └───────────────────┘ └────────────────────┘
Why Bosun?
You run 40 containers on bare metal. Traefik routes traffic. Secrets are everywhere.
You want GitOps -- push a change, everything updates -- but Kubernetes is overkill for a homelab.
Bosun is Helm for home: a single binary that brings GitOps workflows to Docker Compose.
| What you get | How it works |
|---|
| Push-to-deploy | Webhooks or polling trigger reconciliation |
| Secret management | SOPS + Age encryption, decrypted at deploy time |
| Config templating | Go templates + Sprig functions, DRY service definitions |
| Drift detection | Periodic checks: is what's running what you declared? |
| Multi-provider alerts | Discord, SendGrid, Twilio notifications on deploy events |
| Single binary | No Python, no Node, no bash scripts on target |
Architecture
┌─────────────────────────────────────────────────────────────────────────────────┐
│ Your Yacht (Server) │
│ ┌─────────────────────────────────────────────────────────────────────────────┐ │
│ │ Bosun │ │
│ │ ┌────────────────────────────────────┐ ┌──────────────────────────────┐ │ │
│ │ │ │ │ │ │ │
│ │ │ git push │ ┌┄┄┤ Drift Watch / Periodic check │ │ │
│ │ │ │ ┆ │ │ │ │
│ │ └──────────────────┬─────────────────┘ ┆ └──────────────────────────────┘ │ │
│ │ │ ┆ │ │
│ │ ▼ ┆ │ │
│ │ ┌────────────────────────────────────┐ ┆ │ │
│ │ │ │ ┆ │ │
│ │ │ Radio / Webhook/Poll │ ┆ │ │
│ │ │ │ ┆ │ │
│ │ └──────────────────┬─────────────────┘ ┆ │ │
│ │ │ ┆ │ │
│ │ ▼ ┆ │ │
│ │ ┌────────────────────────────────────┐ ┆ │ │
│ │ │ │ ┆ │ │
│ │ │ Fetch Orders / git clone/pull │ ┆ │ │
│ │ │ │ ┆ │ │
│ │ └──────────────────┬─────────────────┘ ┆ │ │
│ │ │ ┆ │ │
│ │ ▼ ┆ │ │
│ │ ┌────────────────────────────────────┐ ┆ │ │
│ │ │ │ ┆ │ │
│ │ │ Decrypt Secrets / SOPS + Age │ ┆ │ │
│ │ │ │ ┆ │ │
│ │ └──────────────────┬─────────────────┘ ┆ │ │
│ │ │ ┆ │ │
│ │ ▼ ┆ │ │
│ │ ┌────────────────────────────────────┐ ┆ │ │
│ │ │ │ ┆ │ │
│ │ │ Prep Configs / Go Templates │ ┆ │ │
│ │ │ │ ┆ │ │
│ │ └──────────────────┬─────────────────┘ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
