Fehlermeldungen

„npm error code ECONNRESET“ auf dem Mac

ECONNRESET bedeutet, dass die Gegenseite die Verbindung gewaltsam geschlossen hat. Die Node.js-Dokumentation nennt es „Connection reset by peer“.

Gilt für: npm 10 und neuer geben „npm error“ aus, ältere Versionen „npm ERR!“. Alle aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • npm install bricht mit npm error code ECONNRESET ab.
  • npm ergänzt, dass es sich um ein Problem mit der Netzwerkverbindung handelt.
  • Es passiert in einem Firmennetzwerk, mit einem VPN oder mit einer Sicherheits-App.

Mögliche Ursachen

  • Ein Proxy oder Filter, der Verbindungen zurücksetzt. Ein Firmen-Proxy oder Sicherheitssoftware kann Verbindungen schließen, die nicht erlaubt sind.
  • TLS-Inspektion. Ein Proxy, der verschlüsselten Datenverkehr prüft, kann die Verbindung unterbrechen. Siehe Zertifikate eines Firmen-Proxys legen Terminal-Tools auf dem Mac lahm.
  • Ein VPN, das sich neu verbindet. Verbindungen über das VPN werden geschlossen, wenn es sich neu verbindet.
  • Eine instabile Verbindung. Laut Node.js-Dokumentation kann ein Timeout oder ein Neustart auf der Gegenseite die Ursache sein.

So prüfst du es

  1. Zeige die Registry- und Proxy-Einstellungen von npm an.

    npm config get registry
npm config get proxy
npm config get https-proxy

  2. Bitte die Registry um eine Antwort.

    npm ping

  3. Teste die Registry mit curl. Achte auf den Aussteller des Zertifikats.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer

  4. Versuche die Installation in einem anderen Netzwerk, etwa im Hotspot eines Smartphones.

So behebst du es

  1. Wenn das Netzwerk einen Proxy braucht, lege ihn für npm fest.

    npm config set https-proxy http://proxy.example.com:8080

  2. Wenn ein Firmen-Proxy TLS prüft, füge sein Root-Zertifikat für Node.js hinzu. Siehe Zertifikate eines Firmen-Proxys legen Terminal-Tools auf dem Mac lahm.

  3. Gib npm mehr Wiederholungsversuche.

    npm config set fetch-retries 5

  4. Ist ein VPN, ein Proxy oder eine Sicherheits-App aktiv, schalte sie für einen kurzen Test aus. Schalte sie danach wieder ein.

Mit Kilobat

  1. Kilobats Verbindungsdiagnose testet die Registry Schicht für Schicht: Netzwerk, Proxy, DNS, Regeln, IPv4, IPv6, TLS und Server. Sie nennt die Schicht, die fehlgeschlagen ist.

    kilobat why https://registry.npmjs.org/

  2. Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit diagnose_connection und diagnose_network aus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.

Fragen

Ist ECONNRESET ein Fehler in meinem Projekt?

Meist nicht. Die Verbindung zur Registry wurde geschlossen. Führe dieselbe Installation zum Vergleich in einem anderen Netzwerk aus.

Quellen

Quellen geprüft am 29. Oktober 2026. Die Manpages sind die mit macOS installierten; öffne eine mit man <name> im Terminal.