Error AtlasError Documentation and Resolution
Back to searchMore Node.js errors

Node.js

Node.js connection was refused by the target service

ECONNREFUSED: connection refused

Node.js tried to connect to a remote service, but nothing accepted the connection at the target host and port.

ECONNREFUSEDnetwork

Observed message

ECONNREFUSED: connection refused

Why it happens

  • The target service is stopped, crashed, or not listening yet.
  • The host or port is incorrect in the client configuration.
  • A firewall, container network, or local binding choice made the service unreachable.

How to fix it

  1. Verify the target service is running and listening on the expected interface and port.
  2. Check the connection settings used by the Node.js client.
  3. Test connectivity between the client and service, especially across containers, VMs, or separate hosts.

Official reference

Node.js Errors

Related errors

ECONNRESETNode.js connection was reset by the peerEADDRINUSENode.js could not bind because the address is already in useETIMEDOUTNode.js operation timed out before completionENOENTNode.js could not find the requested file or directory

Explore more

Node.jsBrowse more Node.js errorsnetworkBrowse more network errors
Node.js ECONNREFUSED connection refused: causes and fixes | Error Atlas