Fehlermeldungen

„npm error code ETIMEDOUT“ auf dem Mac

Q: Wie lange wartet npm?

Laut npm-Dokumentation ist der Standard für fetch-timeout 300000 ms, also fünf Minuten, und für fetch-retries 2.

ETIMEDOUT bedeutet, dass die Gegenseite nicht rechtzeitig geantwortet hat. In der Node.js-Dokumentation heißt es: „the connected party did not properly respond after a period of time.“

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 ETIMEDOUT ab.
npm ergänzt, dass es sich um ein Problem mit der Netzwerkverbindung handelt.
Es schlägt in einem bestimmten Netzwerk fehl, etwa im Firmennetzwerk oder in einem Hotspot.

Mögliche Ursachen

Ein Proxy, den npm nicht kennt. In einem Netzwerk mit Proxy braucht npm die Einstellungen proxy und https-proxy.
Eine nicht erreichbare Registry. Eine alte registry-Einstellung kann auf einen privaten Server zeigen.
Eine langsame oder verlustbehaftete Verbindung. Große Pakete laufen in einem schwachen WLAN oder Hotspot in ein Timeout.
Ein defekter IPv6-Pfad. Die Registry hat eine IPv6-Adresse, und IPv6 funktioniert in deinem Netzwerk nicht.

So prüfst du es

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

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

Bitte die Registry um eine Antwort.
```
npm ping
```
Teste die Registry mit curl, nur über IPv4.
```
curl -4 -I https://registry.npmjs.org/
```
Miss die Verbindung.
```
networkQuality
```

So behebst du es

Wenn das Netzwerk einen Proxy braucht, lege ihn für npm fest.
```
npm config set https-proxy http://proxy.example.com:8080
```
Entferne eine alte Registry-Einstellung, damit npm den Standard verwendet.
```
npm config delete registry
```
Gib npm bei einer langsamen Verbindung mehr Wiederholungsversuche.
```
npm config set fetch-retries 5
```
Führe die Installation nach Möglichkeit in einem schnelleren Netzwerk erneut aus.

Mit Kilobat

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/
```
Prüfe vor einer großen Installation, ob das Netzwerk begrenzt ist, über ein VPN läuft oder langsam ist.
```
kilobat conditions
```
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

Wie lange wartet npm?

Laut npm-Dokumentation ist der Standard für fetch-timeout 300000 ms, also fünf Minuten, und für fetch-retries 2.

Quellen

Node.js-Dokumentation: Common system errors
npm Docs: config
curl(1) und networkQuality(8), Manpage, installiert mit macOS 27.2

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