“UNABLE_TO_GET_ISSUER_CERT_LOCALLY” auf dem Mac

UNABLE_TO_GET_ISSUER_CERT_LOCALLY bedeutet, dass Node.js die Stelle nicht findet, die ein Zertifikat signiert hat. Meist ist ein TLS-prüfender Proxy oder eine private Zertifizierungsstelle die Ursache.

Mit deinem Agenten behebenKopiert einen Prompt für Claude Code, Codex oder jeden Agenten, der das Terminal nutzen kann.

Mein Mac hat dieses Problem: „UNABLE_TO_GET_ISSUER_CERT_LOCALLY“ auf dem Mac. Lies https://kilobat.app/de/guides/npm-unable-to-get-issuer-cert-locally.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.

Gilt für: Node.js, npm und auf Node.js aufbauende Tools unter allen aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • Ein Node.js-Tool bricht mit UNABLE_TO_GET_ISSUER_CERT_LOCALLY ab.
  • Die Meldung kann unable to get local issuer certificate lauten.
  • Browser öffnen dieselbe Website möglicherweise.

Mögliche Ursachen

  • Ein TLS-prüfender Proxy. Ein Firmenproxy signiert den Datenverkehr mit einem eigenen Zertifikat. Siehe Zertifikate von Firmenproxys stören Terminal-Tools auf dem Mac.
  • Eine private Zertifizierungsstelle. Eine Firmen-Registry oder ein Gateway nutzt ein Zertifikat einer Stelle, die Node.js nicht kennt.
  • Eine Sicherheits-App, die HTTPS scannt. Sie fügt ihr eigenes Root-Zertifikat hinzu, das Node.js standardmäßig nicht verwendet.
  • Ein fehlendes Zwischenzertifikat. Ein Server kann einen Teil seiner Zertifikatskette auslassen.

So prüfst du es

  1. Lies den Aussteller aus.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. Zeige die CA-Datei an, die npm verwendet.

    npm config get cafile
  3. Zeige die CA-Variable von Node.js an.

    echo $NODE_EXTRA_CA_CERTS
  4. Probiere einen iPhone-Hotspot.

So behebst du es

  1. Hole das CA-Zertifikat im PEM-Format vom Netzwerkadministrator.

  2. Sage Node.js, dass es ihm in dieser Shell vertrauen soll.

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. Setze für npm dieselbe Datei.

    npm config set cafile /path/to/ca.pem
  4. Setze NODE_TLS_REJECT_UNAUTHORIZED=0 nicht. Es schaltet alle Prüfungen ab.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet den Host Schicht für Schicht. Die TLS-Schicht zeigt ein Zertifikat, dem dieser Mac nicht vertraut.

    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

Warum funktioniert der Browser?

macOS vertraut Zertifikaten, die ein Administrator installiert. Node.js nutzt eine eigene Liste, solange du keine Datei hinzufügst.

Ist NODE_TLS_REJECT_UNAUTHORIZED=0 eine Lösung?

Nein. Es schaltet die Zertifikatsprüfung für jede Verbindung ab. Füge stattdessen die CA hinzu.

Quellen

Geprüft am 29. Oktober 2026.