# ufoscout/docker-compose-wait

A simple script to wait for other docker images to be started while using docker-compose (or Kubernetes or docker stack or whatever)

Repository: https://github.com/ufoscout/docker-compose-wait
Canonical: https://ross.abutalabs.com/products/docker-compose-wait
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: docker, docker-images, dockerfile, kubernetes, sleep, synchronization, wait, containers
Last push: 2026-04-10T19:19:02+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 76, release rhythm 8, longevity 100
- inputs: {"age_days": 3563, "days_push": 145, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1707, forks 141 (observed 2026-08-28T04:05:24.999434+00:00)

## What it is
A small Rust command-line utility that blocks until other Docker containers (or services in Kubernetes/docker stack) are ready, by waiting for a fixed time, open TCP ports, or files on the filesystem. It is typically added to a Dockerfile and run before the application's entrypoint to ensure dependencies like databases are available.

## Use cases
- wait for postgres and mysql to be ready before starting my app in docker-compose
- delay container startup until a tcp port is open
- make my app wait for mongodb in a docker stack deployment
- synchronize service startup order in kubernetes without healthcheck hacks
- wait for a file to exist before launching my application container
- use a wait tool in distroless or scratch docker images

## When to choose
- you use docker-compose, docker stack, or Kubernetes and need simple dependency readiness gating
- you want a tiny static binary that works in scratch or distroless images
- you need to wait on TCP ports or filesystem paths via environment variables

## When to avoid
- your orchestrator already supports healthchecks with depends_on conditions or init containers
- you need complex readiness logic beyond ports, files, or timeouts

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, scheduling, developer-tools
- domain: developer-tools
- platform: cross-platform
- tags: docker-compose, container-orchestration, startup-synchronization, wait-for-service, rust, devops, containers, docker, kubernetes, linux

## Member repositories
- ufoscout/docker-compose-wait (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:24.999434+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-30T03:37:28.185984+00:00, confidence not recorded.
  - readme: https://github.com/ufoscout/docker-compose-wait (fetched 2026-08-28T04:05:24.999434+00:00, sha f6722327c34f)
- Data as of 2026-08-30T08:39:29.467469+00:00.