WHOSEPORT
Investigations · guide

ECONNREFUSED

Refused is not down. Check the listener, the host, the port and the network before naming a cause.

Ask

bash
whoseport ask "ECONNREFUSED 127.0.0.1:6379"

What WhosePort checks

  • Is anything listening on that host and port
  • Is the service published to the host or only inside a compose network
  • Does the caller run on the host or in a container

Typical root cause

A host process using 127.0.0.1 while the service is only reachable by its compose service name, or the reverse.

Proposed fix

  • update_runtime_config: the host in the caller's .env (approval required)
  • Or a written explanation of the port to publish in compose
Approval
Every step that changes your machine is a typed action classed by the policy engine. It waits for your approval in the dashboard, which shows the target, risk and expected effect first. A changed .env file is backed up before it is written. See /docs/policy.

Verification

  • TCP connect to the target succeeds
  • The caller answers over HTTP