bosun

Render Docker Compose manifests and reconcile GitOps deployments with drift detection.

1|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/cameronsjo/bosun --skill bosun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bosun
Source: https://github.com/cameronsjo/bosun/tree/main/skills/onboard
Command: npx skills add https://github.com/cameronsjo/bosun --skill bosun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bosun automates GitOps workflows for homelab Docker Compose deployments, reducing manual ops and drift.

Core Features & Use Cases

  • Render manifests into Docker Compose, Traefik, and Gatus configurations
  • One-shot reconcile or daemon-based GitOps for automated deployments
  • Drift detection and secret management (SOPS + Age)

Quick Start

Initialize a project with bosun init, render manifests with bosun provision, and deploy the stack with bosun yacht up.

Frequently Asked Questions about bosun

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitOps deployments for homelab Docker Compose stacks?

You can automate GitOps deployments for homelab Docker Compose stacks by rendering manifests into deployable configurations and reconciling state through either one-shot or daemon-based reconciliation. Bosun specifically handles this workflow by rendering Docker Compose, Traefik, and Gatus configurations.

What is the best way to detect configuration drift in a homelab Docker Compose setup?

Drift detection in a homelab Docker Compose setup is managed through automated state reconciliation. The system compares your rendered manifests against the live deployment configuration, ensuring repeatable config and identifying any manual changes that deviate from the desired state.

How does secret management work with SOPS and Age for Docker Compose GitOps?

Secret management with SOPS and Age for Docker Compose GitOps involves decrypting secrets during the manifest rendering process. SOPS handles the encryption of sensitive data, while Age provides the cryptographic key management, allowing secure secret interpolation into your deployable configurations.

Can I use Bosun for small team deployments or is it only for local homelabs?

Bosun applies to both local homelab deployments and small teams needing repeatable config. It provides the same drift detection, secret management, and manifest rendering capabilities for collaborative environments as it does for single-user homelab Docker Compose stacks.

How do I initialize and deploy a Docker Compose stack using a GitOps workflow?

To initialize and deploy a Docker Compose stack via GitOps, run bosun init to start the project, bosun provision to render your manifests into deployable configurations, and bosun yacht up to deploy the final stack to your homelab environment.