Introduction
Auto-deploy and auto-heal agent for self-hosted Docker containers.
Last updated: February 28, 2026
Dockward
Single static Go binary (~12 MB), zero external dependencies. Monitors a local Docker registry, auto-deploys via docker compose with rollback on failure, blocks bad digests, and auto-heals unhealthy containers. Designed for single-host deployment on bare metal or a VPS.
Two Operational Modes
Full mode — registry polling + auto-deploy with rollback + auto-heal. Requires a local Docker registry and docker compose files on the host.
Heal-only mode — Docker event monitoring + auto-restart. Works with any container, compose-managed or standalone. No registry or compose files needed.
Getting Started
- Quick Start — up and running in 5 minutes
- Installation — binary, build from source, systemd
- Configuration — config file walkthrough
- GitHub Actions — self-hosted runner CI/CD
Guides
- Full Mode — deploy flow, health grace, concurrent guards
- Heal-Only Mode — event matching, cooldown, max restarts
- Rollback — rollback triggers, digest blocking, manual unblock
- Config Wizard — interactive CLI setup
- Audit Log — enable, format, event types, rotation
- Troubleshooting — common problems and fixes
Reference
- Config Reference — all fields, defaults, validation rules
- API Reference — HTTP endpoints and response shapes
- Web UI — dashboard layout, controls, SSE feed
- Metrics — Prometheus metrics
- Notifications — Discord, SMTP, webhooks, event types
Warden
- Warden Reference — config, endpoints, auth model
- Warden Setup — multi-machine deployment guide