# wowu/docker-rollout

🚀 Zero Downtime Deployment for Docker Compose

Repository: https://github.com/wowu/docker-rollout
Canonical: https://ross.abutalabs.com/products/docker-rollout
Homepage: https://docker-rollout.wowu.dev/
Language: Shell
License: MIT
License Family: permissive
Topics: deployment, docker, docker-compose
Last push: 2026-07-12T19:47:30+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 80, longevity 93
- inputs: {"age_days": 1304, "days_push": 52, "days_rel": 52, "gap_med": 59.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3320, forks 103 (observed 2026-08-28T04:07:56.229314+00:00)

## What it is
docker-rollout is a Docker CLI plugin (a single bash script) that updates Docker Compose services with zero downtime. It scales the service to twice its instances, waits for new containers to become healthy, then removes the old containers.

## Use cases
- deploy docker compose services without downtime
- replace docker compose up -d in deployment scripts
- rolling update for docker compose
- zero downtime deployment with healthchecks
- blue-green style deploys on a single host
- gracefully drain old containers during deploy

## When to choose
- you deploy with Docker Compose on a single host and need zero-downtime updates
- you want a dependency-free bash script instead of a full orchestrator
- you already use a reverse proxy with service discovery like Traefik or nginx-proxy

## When to avoid
- your compose services define container_name or port mappings, which prevent running multiple instances
- you have no reverse proxy to route traffic between old and new containers
- you need multi-host orchestration, where Swarm or Kubernetes is a better fit

## Facets
- artifact type: plugin
- maturity: active
- function: deployment, cli, container-orchestration
- domain: self-hosted, developer-tools
- platform: cli
- tags: docker-compose, zero-downtime, blue-green-deployment, docker-cli-plugin, shell-script, healthcheck, reverse-proxy, devops, containers, linux, macos, docker

## Member repositories
- wowu/docker-rollout (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:56.229314+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:41:51.430025+00:00, confidence not recorded.
  - readme: https://github.com/wowu/docker-rollout (fetched 2026-08-28T04:07:56.229314+00:00, sha 1309d56d5cf5)
  - homepage: https://docker-rollout.wowu.dev/ (fetched 2026-08-29T09:34:54.973669+00:00, sha e9e65eb14476)
  - site_page: https://docker-rollout.wowu.dev/getting-started.html (fetched 2026-08-29T09:34:54.976781+00:00, sha 8f0a664ae06f)
  - site_page: https://docker-rollout.wowu.dev/uninstalling.html (fetched 2026-08-29T09:34:54.978475+00:00, sha 4709723e9aa5)
  - site_page: https://docker-rollout.wowu.dev/getting-started (fetched 2026-08-29T09:34:54.980028+00:00, sha 8f0a664ae06f)
- Data as of 2026-08-30T08:39:29.467469+00:00.