Skip to main content
Polls the health endpoint until the proxy reports ready. Useful in Procfiles, scripts, and CI pipelines to ensure the proxy is accepting connections before starting dependent applications.

​
Usage

cordon wait [OPTIONS]

​
Options

OptionDefaultDescription
--urlderived from config, else http://127.0.0.1:6790/healthHealth check URL. Overrides and conflicts with --config and --scope.
--config, -c—Read listen from this config file. Mutually exclusive with --url and --scope.
--scopeprojectRead listen from the selected scope’s config. Mutually exclusive with --url and --config.
--timeout30Timeout in seconds
Without --url, cordon wait uses the selected config’s listen port. With no flags, it tries project scope first and falls back to http://127.0.0.1:6790/health if no project config exists.

​
Examples

# Wait with defaults
cordon wait

# Wait with custom timeout
cordon wait --timeout 60

# Wait on the user-scope proxy
cordon wait --scope user

# Wait on an explicit health URL
cordon wait --url http://127.0.0.1:7000/health

# Use in a Procfile
# web: cordon wait && npm run dev

​
Exit codes

CodeMeaning
0Proxy is ready
1Timeout reached — proxy did not become ready