docker-orchestrate

A Docker CLI plugin to deploy Docker Compose services with support for rolling updates, cron scheduling, custom healthchecks, and container naming conventions.

Installation

Install with the quick install script:

curl -fsSL https://raw.githubusercontent.com/dokku/docker-orchestrate/main/install.sh | sh

Or via Homebrew:

brew install dokku/repo/docker-orchestrate

Or build from source:

make install

See the Getting Started guide for all distribution channels (Debian/Ubuntu packages, binary downloads, etc.).

Once installed, the plugin is available via docker orchestrate.

Usage

Deploy all services in a compose file:

docker orchestrate deploy

Deploy a specific service:

docker orchestrate deploy web

Run scheduled one-shot tasks via the built-in cron daemon:

docker orchestrate cron -f docker-compose.yml -p myproject

See the command reference for all flags and options.

Documentation

• Getting Started -- why docker-orchestrate, installation, and your first deploy
• Command Reference -- all CLI flags and arguments
• Deployment Configuration -- rolling updates, replicas, rollback, and deployment order
• Healthchecks -- Docker and script-based health validation
• Hooks and Scripts -- lifecycle hooks, deploy/stop commands, and templating
• Image Management -- pull policy, building images, and volume warnings
• One-Shot Services -- migrations, cache warming, and run-to-completion tasks
• Cron Scheduling -- scheduling one-shot services as recurring cron tasks
• Skipping Services -- excluding databases, labeled services, models, and providers
• Volumes -- anonymous volume warnings during rolling updates

License

MIT