---
title: "npm error code ECONNRESET auf dem Mac: warum Verbindungen zurückgesetzt werden · Kilobat-Anleitungen"
url: "https://kilobat.app/de/guides/npm-econnreset.html"
description: "npm install bricht auf deinem Mac mit npm error code ECONNRESET ab. Finde den Proxy, das VPN, den Filter oder das Netzwerk, das die Verbindung zurücksetzt, und behebe das Problem."
---

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](https://kilobat.app/de/guides/corporate-proxy-certificates.html).
- **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](https://kilobat.app/de/guides/corporate-proxy-certificates.html).
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](https://kilobat.app/de/guides/recipes/why-cant-it-connect.html).

## 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

- [Node.js-Dokumentation: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- intro(2), ECONNRESET, Manpage, installiert mit macOS 27.2
- [npm Docs: config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1), Manpage aus macOS 27.2

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

## Verwandte Anleitungen

- [„npm error code ETIMEDOUT“ auf dem Mac](https://kilobat.app/de/guides/npm-etimedout.html): ETIMEDOUT bedeutet, dass die Gegenseite nicht rechtzeitig geantwortet hat.
- [Homebrew- oder npm-Downloads scheitern auf dem Mac](https://kilobat.app/de/guides/homebrew-npm-download-fails.html): Homebrew lädt mit curl und Git herunter.
- [Firmenproxy-Zertifikate legen Terminal-Tools auf dem Mac lahm](https://kilobat.app/de/guides/corporate-proxy-certificates.html): Manche Firmennetzwerke prüfen HTTPS-Datenverkehr.
- [Proxy-Einstellungen blockieren App-Verbindungen auf dem Mac](https://kilobat.app/de/guides/proxy-settings-breaking-apps.html): Eine Proxy-Einstellung leitet den Datenverkehr über einen anderen Server.