Context
ctrl is the Docker Swarm operations repo for kuhree.com services. It contains stack definitions and deploy controls for service lifecycle management.
Goals
- Keep Swarm stacks reproducible and versioned.
- Simplify routine stack operations for single-stack and full-fleet deploys.
- Maintain reliable service rollout/rollback workflows.
Implementation
Stack
- Docker Swarm stack definitions
- Service deploy commands via
just up <stack>,just up, andjust down <stack> - Reverse proxy + app/service stack orchestration
Architecture / Integrations
- Service-layer counterpart to host-level NixOS config in
flake - Uses Docker context/swarm manager workflows for cluster operations
- Supports homelab app platform (media, git, vault, automation, utility services)
Repos / URLs
- Repo: https://git.kuhree.com/kuhree.com/ctrl
- Related project: flake
- Parent project: kuhree.com
Status
Active.
Next actionable milestone: reconcile active stack inventory with production reality and retire stale/unused stack configs.
Lessons
- Keep stack naming and ownership consistent to cut deployment mistakes.
- A small set of canonical
justcommands makes ops much faster under pressure.
Notes
- Prefer feature branches and PRs for service changes unless explicitly directed otherwise.
