“SELF_SIGNED_CERT_IN_CHAIN” in npm auf dem Mac

SELF_SIGNED_CERT_IN_CHAIN bedeutet, dass die Zertifikatskette ein Zertifikat enthält, das keine bekannte Zertifizierungsstelle signiert hat. In einem Firmennetzwerk ist meist ein TLS-prüfender Proxy die Quelle.

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

Mein Mac hat dieses Problem: „SELF_SIGNED_CERT_IN_CHAIN“ in npm auf dem Mac. Lies https://kilobat.app/de/guides/npm-self-signed-cert-in-chain.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: npm unter allen aktuellen macOS-Versionen. Der Fehler erscheint auch in anderen Node.js-Tools.Geprüft: 29. Oktober 2026

Symptome

  • npm install bricht mit npm error code SELF_SIGNED_CERT_IN_CHAIN ab.
  • Die Meldung lautet self-signed certificate in certificate chain.
  • Er beginnt in einem Firmennetzwerk oder nachdem eine Sicherheits-App installiert wurde.

Mögliche Ursachen

  • Ein TLS-prüfender Proxy. Der Proxy ersetzt das Zertifikat der Registry durch sein eigenes. Siehe Zertifikate von Firmenproxys stören Terminal-Tools auf dem Mac.
  • Eine Sicherheits-App, die HTTPS scannt. Sie kann dem Datenverkehr ihr eigenes Root-Zertifikat hinzufügen.
  • Ein altes npm. Die Seite „Common errors“ von npm sagt, dass npm seine früheren selbstsignierten Zertifikate nicht mehr unterstützt.
  • Eine private Registry. Eine Registry mit einer privaten Zertifizierungsstelle braucht das Zertifikat dieser Stelle.

So prüfst du es

  1. Lies den Aussteller des Registry-Zertifikats 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. Prüfe die npm-Version.

    npm --version
  4. Probiere einen iPhone-Hotspot. Wenn es klappt, prüft das erste Netzwerk TLS.

So behebst du es

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

  2. Verweise npm darauf.

    npm config set cafile /path/to/ca.pem
  3. Aktualisiere npm, wenn es alt ist.

    npm install npm -g
  4. Setze strict-ssl nicht auf false. Die npm-Dokumentation rät davon ab.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet die Registry 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

Ist npm config set strict-ssl false sicher?

Es schaltet die Zertifikatsprüfung ab. Die npm-Dokumentation rät bei Proxy-Fehlern davon ab. Füge stattdessen die CA des Proxys hinzu.

Warum erscheint der Fehler nur bei der Arbeit?

Ein Proxy, der TLS prüft, signiert den Datenverkehr mit einem eigenen Zertifikat. Dein Mac vertraut ihm nicht.

Quellen

Geprüft am 29. Oktober 2026.