---
title: "ERR_CONNECTION_REFUSED in Chrome on Mac · Kilobat Guides"
url: "https://kilobat.app/guides/err-connection-refused"
description: "Chrome on your Mac shows ERR_CONNECTION_REFUSED. Find out whether no service listens, a firewall refuses, or a proxy or VPN is involved."
---

# ERR_CONNECTION_REFUSED in Chrome on Mac

ERR_CONNECTION_REFUSED is a Chrome network error. The Chromium source describes it as: “A connection attempt was refused.”

**Fix this with your agent**Copies a prompt for Claude Code, Codex or any agent that can use Terminal.

My Mac has this problem: ERR_CONNECTION_REFUSED in Chrome on Mac. Read https://kilobat.app/guides/err-connection-refused.md and work through it with me. Install the Kilobat CLI if it’s missing: brew install seifip/kilobat/kilobat. Run the guide’s Terminal and kilobat checks yourself and tell me what you find. List the steps only I can do. Ask before you change any setting.

Applies to: Google Chrome and other Chromium browsers (Edge, Brave, Arc) on all current macOS versions. · Checked: 29 October 2026

## Symptoms

- Chrome shows “This site can’t be reached” and ERR_CONNECTION_REFUSED.
- The address resolves, but nothing accepts the connection on that port.
- It often happens with `localhost` and development servers.

## Likely causes

- **No service is listening.** The server or app is not running, or it listens on another port.
- **A firewall rejects the port.** A firewall on the server or the network can refuse the connection.
- **A wrong address or port.** A typing error or an old bookmark points to a port that is closed.
- **A VPN or proxy.** Traffic goes through a VPN or proxy that refuses it.

## How to check

1. Check the address and the port in the address bar.
2. Test the port from Terminal. “refused” confirms the cause.

   ```
   nc -vz localhost 3000
   ```
3. List what listens on the port.

   ```
   lsof -nP -iTCP:3000 -sTCP:LISTEN
   ```
4. Run curl with details to see the refusal.

   ```
   curl -v https://example.com
   ```

## How to fix it

1. Start the server or app that should listen. Use the port it prints.
2. For a remote site, wait and retry. The service may be down.
3. Turn off the VPN for a short test. Turn it on again after.
4. If the port is busy with another app, see [Port already in use on a Mac](https://kilobat.app/guides/port-already-in-use).

## With Kilobat

1. Kilobat's connection doctor tests the address layer by layer: network, proxy, DNS, rules, IPv4, IPv6, TLS and the server. It names the layer that failed.

   ```
   kilobat why https://example.com
   ```
2. These Kilobat checks are free. AI agents run them through MCP with `diagnose_connection` and `diagnose_network`. See [Find why one site or API won't connect](https://kilobat.app/guides/recipes/why-cant-it-connect).

## Questions

**Is ERR_CONNECTION_REFUSED a DNS problem?**

No. The name resolved and the host answered with a refusal. For DNS errors see [ERR_NAME_NOT_RESOLVED in Chrome on Mac](https://kilobat.app/guides/err-name-not-resolved).

**Why does only Chrome fail?**

Chrome may use a proxy or an IPv6 address that other tools skip. Compare with curl.

## Sources

- [Chromium source: net_error_list.h](https://chromium.googlesource.com/chromium/src/+/main/net/base/net_error_list.h)
- [Chrome Help: Fix connection errors](https://support.google.com/chrome/answer/95669)

Checked on 29 October 2026.

## Related guides

- [ERR_CONNECTION_TIMED_OUT in Chrome on Mac](https://kilobat.app/guides/err-connection-timed-out): Chromium describes this error as: “A connection attempt timed out.” Chrome found the address, but the server did not answer in time.
- [Port already in use on a Mac](https://kilobat.app/guides/port-already-in-use): Only one process can listen on a TCP port and address.
- [ERR_CONNECTION_RESET in Chrome on Mac](https://kilobat.app/guides/err-connection-reset): ERR_CONNECTION_RESET is a Chrome network error.
- [Proxy settings stop apps from connecting on a Mac](https://kilobat.app/guides/proxy-settings-breaking-apps): A proxy setting sends traffic through another server.
