bosun

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     │  ┆                                   │ │
│ │ │                                    │  ┆                                   │ │
│ │ └──────────────────┬─────────────────┘  ┆                                   │ │
│ │                    │                    ┆                                   │ │
│ │                    │                    ┆                                   │ │