---
title: "npm error code ETIMEDOUT auf dem Mac: Netzwerk-Timeouts von npm beheben · Kilobat-Anleitungen"
url: "https://kilobat.app/de/guides/npm-etimedout.html"
description: "npm install bricht auf deinem Mac mit npm error code ETIMEDOUT ab. Prüfe Registry, Proxy und Verbindung und passe dann die Einstellungen von npm an."
---

Fehlermeldungen

# „npm error code ETIMEDOUT“ auf dem Mac

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

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, nur über IPv4.

   ```
   curl -4 -I https://registry.npmjs.org/
   ```
4. Miss die Verbindung.

   ```
   networkQuality
   ```

## 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. Entferne eine alte Registry-Einstellung, damit npm den Standard verwendet.

   ```
   npm config delete registry
   ```
3. Gib npm bei einer langsamen Verbindung mehr Wiederholungsversuche.

   ```
   npm config set fetch-retries 5
   ```
4. Führe die Installation nach Möglichkeit in einem schnelleren Netzwerk erneut aus.

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

   ```
   kilobat conditions
   ```
3. 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

**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](https://nodejs.org/api/errors.html#common-system-errors)
- [npm Docs: config](https://docs.npmjs.com/cli/v11/using-npm/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.

## Verwandte Anleitungen

- [„npm error code ECONNRESET“ auf dem Mac](https://kilobat.app/de/guides/npm-econnreset.html): ECONNRESET bedeutet, dass die Gegenseite die Verbindung abrupt geschlossen 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.
- [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.
- [Firmenproxy-Zertifikate legen Terminal-Tools auf dem Mac lahm](https://kilobat.app/de/guides/corporate-proxy-certificates.html): Manche Firmennetzwerke prüfen HTTPS-Datenverkehr.
- [Netzwerk vor einem großen Download in einem Agenten prüfen](https://kilobat.app/de/guides/recipes/check-network-before-download.html): Ein Agent kann Kilobat fragen, ob gerade ein guter Zeitpunkt für eine große Übertragung ist.