npx claudepluginhub cameronsjo/bosunGitOps CLI for Docker Compose on bare metal
cameronsjoShare bugs, ideas, or general feedback.
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 │
│ │ │ │ │ │ │ │ │ │ │ │ │ │
└──────────┘ └───────────────────────┘ └─────────────────┘ └──────────────────┘ └──────────────────┘ └───────────────────┘ └────────────────────┘
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 |
┌─────────────────────────────────────────────────────────────────────────────────┐
│ Your Yacht (Server) │
│ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────────────┐ │
│ │ Bosun │ │
│ │ │ │
│ │ │ │
│ │ ┌────────────────────────────────────┐ ┌──────────────────────────────┐ │ │
│ │ │ │ │ │ │ │
│ │ │ git push │ ┌┄┄┤ Drift Watch / Periodic check │ │ │
│ │ │ │ ┆ │ │ │ │
│ │ └──────────────────┬─────────────────┘ ┆ └──────────────────────────────┘ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ ▼ ┆ │ │
│ │ ┌────────────────────────────────────┐ ┆ │ │
│ │ │ │ ┆ │ │
│ │ │ Radio / Webhook/Poll │ ┆ │ │
│ │ │ │ ┆ │ │
│ │ └──────────────────┬─────────────────┘ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ │ ┆ │ │
│ │ ▼ ┆ │ │
│ │ ┌────────────────────────────────────┐ ┆ │ │
│ │ │ │ ┆ │ │
│ │ │ Fetch Orders / git clone/pull │ ┆ │ │