---
title: "brew install oder npm install scheitert auf dem Mac mit Netzwerkfehlern · Kilobat-Anleitungen"
url: "https://kilobat.app/de/guides/homebrew-npm-download-fails.html"
description: "Finde heraus, warum brew install oder npm install mit Timeouts, Proxy- oder Zertifikatsfehlern abbricht, und richte den Proxy, den Mirror oder das Zertifikat ein, das dein Netzwerk braucht."
---

Entwickler

# Homebrew- oder npm-Downloads scheitern auf dem Mac

Homebrew lädt mit curl und Git herunter. npm lädt aus seiner Registry. Jedes Tool liest seine eigenen Proxy- und Zertifikatseinstellungen.

Gilt für: aktuelles Homebrew und npm auf allen aktuellen macOS-Versionen. · Geprüft: 29. Oktober 2026

## Symptome

- `brew install` bricht mit „curl: (28) … timed out“ oder „Failed to download resource“ ab.
- `npm install` bricht mit ETIMEDOUT, ECONNRESET oder einem Zertifikatsfehler ab.
- Downloads scheitern nur in einem Firmennetzwerk oder über VPN.
- Downloads starten und brechen dann bei einer langsamen Verbindung ab.

## Mögliche Ursachen

- **Ein Proxy, den das Tool nicht kennt.** Homebrew verwendet `http_proxy`, `https_proxy` und `all_proxy`. npm verwendet seine Einstellungen `proxy` und `https-proxy` oder dieselben Variablen.
- **TLS-Inspektion.** Ein Firmen-Proxy signiert den Datenverkehr mit einem eigenen Zertifikat. Siehe [Zertifikate eines Firmen-Proxys stören Terminal-Tools auf dem Mac](https://kilobat.app/de/guides/corporate-proxy-certificates.html).
- **Eine falsche npm-Registry.** Eine alte Einstellung `registry` kann auf einen Server zeigen, den du nicht erreichst.
- **Eine langsame oder begrenzte Verbindung.** Große Downloads können bei schwachem WLAN oder über einen Hotspot ins Timeout laufen.

## So prüfst du es

1. Lass Homebrew dein System prüfen.

   ```
   brew doctor
   ```
2. Zeige die Homebrew- und Systemkonfiguration an.

   ```
   brew config
   ```
3. Zeige die Registry- und Proxy-Einstellungen von npm an.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
4. Sende eine Anfrage an die npm-Registry.

   ```
   npm ping
   ```
5. Teste den Download-Host direkt mit curl.

   ```
   curl -v -o /dev/null https://formulae.brew.sh/api/formula.json
   ```

## So behebst du es

1. Für Homebrew hinter einem Proxy: Setze die Proxy-Variable in derselben Shell.

   ```
   export https_proxy=http://proxy.example.com:8080
   ```
2. Für npm hinter einem Proxy: Setze den npm-Proxy.

   ```
   npm config set https-proxy http://proxy.example.com:8080
   ```
3. Entferne eine alte Registry-Einstellung, damit npm seinen Standard nutzt.

   ```
   npm config delete registry
   ```
4. Lass Homebrew einen fehlgeschlagenen Download öfter versuchen.

   ```
   export HOMEBREW_CURL_RETRIES=5
   ```
5. Wenn deine Firma einen Mirror nutzt, richte ihn ein. Homebrew verwendet für Mirrors `HOMEBREW_BOTTLE_DOMAIN` und `HOMEBREW_API_DOMAIN`.
6. Bei Zertifikatsfehlern füge das Root-Zertifikat der Firma hinzu. Siehe [Zertifikate eines Firmen-Proxys stören Terminal-Tools auf dem Mac](https://kilobat.app/de/guides/corporate-proxy-certificates.html).

## Mit Kilobat

1. Prüfe vor einer großen Installation, ob das Netzwerk begrenzt, ein VPN oder langsam ist.

   ```
   kilobat conditions
   ```
2. Finde die Schicht, die den Download-Host blockiert. Füge `--app` hinzu, um die Proxy-Variablen dieses Prozesses zu nutzen.

   ```
   kilobat why https://ghcr.io/v2/homebrew/core --app process:curl
   ```
3. Halte den Mac wach, während die Installation läuft.

   ```
   kilobat awake -- brew upgrade
   ```
4. Diese Befehle sind kostenlos. Siehe [Netzwerk vor einem großen Download in einem Agenten prüfen](https://kilobat.app/de/guides/recipes/check-network-before-download.html).

## Fragen

**Nutzt Homebrew den Proxy aus den Systemeinstellungen?**

Die Homebrew-Dokumentation nennt Proxy-Variablen für curl, Git und Subversion. Setze `https_proxy` in deiner Shell.

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

- [Homebrew Docs: Manpage, Umgebungsvariablen](https://docs.brew.sh/Manpage)
- [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

- [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.
- [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.
- [SSH und Git laufen auf dem Mac in Timeouts](https://kilobat.app/de/guides/ssh-git-timeouts.html): SSH und Git brauchen eine funktionierende TCP-Verbindung zum Server.
- [„npm error code ETIMEDOUT“ auf dem Mac](https://kilobat.app/de/guides/npm-etimedout.html): ETIMEDOUT bedeutet, dass die Gegenseite nicht rechtzeitig geantwortet hat.