vishnubob/wait-for-it

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

9772 stars · 2235 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

wait-for-it is a pure bash script that tests and waits for the availability of a TCP host and port, with optional timeout and strict mode. It is commonly used to synchronize the startup of interdependent services such as linked Docker containers.

Use cases

• wait for a database to be ready before starting an app in docker-compose
• block a container startup until a dependent service's TCP port is open
• check if a host and port are reachable from a shell script
• delay service startup until another container is listening
• run a command only after a service becomes available

When to choose

• you need a dependency-free bash script to gate startup on TCP availability
• you orchestrate docker containers with inter-service startup dependencies
• you want a tiny, portable readiness check for shell scripts

When to avoid

• you need HTTP-level health checks rather than raw TCP port checks
• you want a full service orchestration or init system like supervisord or s6
• you need readiness checks in a non-bash environment without a shell

Facets

cli-tool · maturity maintenance

cli networking developer-tools deployment developer-tools cli cross-platform bash-script tcp-health-check docker-compose service-readiness container-orchestration-helper devops containers command-line linux macos docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="vishnubob/wait-for-it")