macOS
Homebrewverified · 100%
brew install wait4xlocal Homebrew formula metadata
brew / rank 9181
Install wait4x with Homebrew, apk, Nix, zypper, scoop
Wait for a port or a service to enter the requested state. Version 3.6.0 via Homebrew; verified 2026-05-09. Also installable with nix: nix profile install nixpkgs#wait4x.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add wait4xAlpine Linux edge package indexes · wait4x · source: dl-cdn.alpinelinux.org
Nixverified · 92%
nix profile install nixpkgs#wait4xnixpkgs package indexes · pkgs/by-name/wa/wait4x/package.nix · source: api.github.com
openSUSE zypperverified · 92%
sudo zypper install wait4xopenSUSE Tumbleweed package metadata · wait4x · source: download.opensuse.org
Windows
Scoopverified · 92%
scoop install extras/wait4xScoop official bucket manifest trees · bucket/wait4x.json · source: api.github.com
overview
Package summary
Wait for a port or a service to enter the requested state
Project links
Commands and aliases
- wait4x
history
Project history and usage
Wait4X is a Go-based readiness-waiting tool for scripts, CI jobs, containers, and local development. Its job is deliberately narrow: block until a port, protocol endpoint, database, message broker, or other service reaches the expected state, then optionally run a command.
Project history
The GitHub repository was created on November 1, 2019, and GitHub release metadata shows v0.1.0 published on February 8, 2020. The project later adopted the `wait4x.dev/v3` module path and documents itself as a lightweight, zero-dependency tool for modern infrastructure readiness checks.
By 2025 the release series had reached v3.6.0, and the README described a broader surface than simple TCP waiting: TCP, HTTP, DNS, Redis, MySQL, PostgreSQL, MongoDB, Kafka, RabbitMQ, InfluxDB, Temporal, reverse checks, parallel checks, exponential backoff, and command execution after checks.
Adoption history
Wait4X lives in the same operational niche as `wait-for-it`, `dockerize`, Kubernetes readiness checks, and ad hoc shell loops, but its pitch is one static cross-platform binary with service-aware checks. As of July 2, 2026, GitHub API metadata showed about 1,339 stars and 54 forks, which is meaningful adoption for a focused infrastructure CLI.
How it is used
Typical usage is inline in automation: `wait4x tcp localhost:5432`, `wait4x http https://example.com/health --expect-status-code 200`, or `wait4x postgresql postgres://...` before a test suite or startup script continues. The README also shows multiple targets checked in parallel and an `--invert-check` mode for waiting until a service becomes unavailable.
Because it can run a command after readiness succeeds, Wait4X often replaces a shell loop in Docker entrypoints, CI workflow steps, and local scripts where a database, cache, broker, or API needs to be up before the next process starts.
Why package nerds care
Its package-nerd significance is the consolidation of many tiny readiness patterns into one binary. It does not define a protocol or framework, but it is useful glue in the places where package managers, containers, and CI systems expose race conditions between service startup and test execution.
Timeline
- November 1, 2019: the wait4x/wait4x repository was created on GitHub.
- February 8, 2020: v0.1.0 was published as an early GitHub release.
- October 20, 2025: v3.6.0 was published, showing the project had continued into a v3 line with a wider readiness-check surface.
- July 2, 2026: GitHub API metadata showed the project still present as a moderate-sized infrastructure CLI repository.
Related projects
- Related tools include `wait-for-it`, `dockerize`, and health-check mechanisms in Docker Compose and Kubernetes. Wait4X differs by shipping a single CLI with multiple protocol and service-specific checks rather than relying only on raw TCP ports or shell scripting.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for wait4x. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
wait4x | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version3.6.0
manager updated2026-05-09
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:wait4x |
|---|---|
| Version | 3.6.0 |
| Package manager | Homebrew |
| Homepage | https://wait4x.dev |
| Repository | https://github.com/wait4x/wait4x |
| Last updated | 2026-05-09T15:13:04Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
wait4x
nix profile install nixpkgs#wait4x- normalized package name match
- Matched by: Wait4x
apk95%
wait4x 3.6.0-r3
Wait4X allows you to wait for a port or a service to enter the requested state
sudo apk add wait4x- License: Apache-2.0
- Architecture: x86_64
- Source Package: wait4x
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Wait4x
apk95%
wait4x-bash-completion 3.6.0-r3
Bash completions for wait4x
sudo apk add wait4x-bash-completion- License: Apache-2.0
- Architecture: x86_64
- Source Package: wait4x
- normalized package name match
- Matched by: Wait4x
apk95%
wait4x-doc 3.6.0-r3
Wait4X allows you to wait for a port or a service to enter the requested state (documentation)
sudo apk add wait4x-doc- License: Apache-2.0
- Architecture: x86_64
- Source Package: wait4x
- normalized package name match
- Matched by: Wait4x
apk95%
wait4x-fish-completion 3.6.0-r3
Fish completions for wait4x
sudo apk add wait4x-fish-completion- License: Apache-2.0
- Architecture: x86_64
- Source Package: wait4x
- normalized package name match
- Matched by: Wait4x
apk95%
wait4x-zsh-completion 3.6.0-r3
Zsh completions for wait4x
sudo apk add wait4x-zsh-completion- License: Apache-2.0
- Architecture: x86_64
- Source Package: wait4x
- normalized package name match
- Matched by: Wait4x
zypper95%
wait4x 3.6.0-1.6
Wait for a port or a service to enter the requested state
https://github.com/wait4x/wait4x
sudo zypper install wait4x- License: Apache-2.0
- Category: Unspecified
- Architecture: x86_64
- Source Package: wait4x
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Wait4x
Scoop95%
extras/wait4x
scoop install extras/wait4x- normalized package name match
- Matched by: Wait4x
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation