Verbindungsprobleme beheben

Was tun, wenn BuildCaptain Jenkins nicht erreicht: HTTPS-Anforderungen, Proxys und Login-Seiten, Tokens, Berechtigungen und das fehlende Plugin.

Geschrieben von Loris Siegenthaler · Macher von BuildCaptain

3 Min. Lesezeit

Aktualisiert am 20. August 2026

Bricht die Verbindung ab, zeigt BuildCaptain ein oranges Banner in der Seitenleiste mit dem Grund sowie Retry- und Settings-Buttons. Fehler vom Server öffnen einen Dialog mit einer verständlichen Zusammenfassung — klappe "What the server sent" auf, um die Rohantwort zu sehen, und nutze Copy Details, wenn du ein Problem meldest.

"The Jenkins URL is invalid" / HTTP abgelehnt

BuildCaptain akzeptiert https://-URLs sowie – ab BuildCaptain 26.8.3 – unverschlüsseltes http:// nur für private Netzwerkadressen — IP-Adressen wie 10.x.x.x, 172.16–31.x.x, 192.168.x.x und localhost. Das deckt interne Jenkins-Instanzen ab, deren Verkehr dein LAN oder VPN nie verlässt. Ein reiner HTTP-Hostname (z. B. http://jenkins.example.com/) wird bewusst abgelehnt, weil er deinen API-Token unterwegs offenlegen würde — verbinde dich in dem Fall über die private IP-Adresse des Servers, oder besser: setze einen TLS-terminierenden Reverse-Proxy vor Jenkins.

Antwortet der Server mit etwas, das kein Jenkins ist — Cloudflare Access, ein VPN-Portal, eine Firmen-SSO-Seite —, meldet BuildCaptain, dass möglicherweise ein Proxy oder eine Login-Seite die Anfrage abfängt, und zeigt die erhaltene Antwort. Stelle sicher, dass API-Anfragen an deinen Jenkins-Host das interaktive Login umgehen (z. B. per Service-Token-Header am Proxy, oder verbinde dich zuerst mit dem VPN).

401 — Token abgelehnt

Das Paar aus Benutzername und Token ist falsch, oder der Token wurde widerrufen. Erstelle in Jenkins einen frischen API-Token (dein Name → Security → API Token) und trage ihn in den Einstellungen neu ein. Hinweis: Verwende den Token, nicht dein Account-Passwort.

403 — keine Berechtigung

Deinem Account fehlt eine Berechtigung für diese Aktion — Lesen erfordert Job/Read; Starten/Stoppen/Neustarten erfordern Job/Build und Job/Cancel. Die Meldung des Servers findest du in den Fehlerdetails.

404 beim Graphen — Plugin fehlt

Wenn die Pipeline-Liste funktioniert, aber die Stage-Ansicht einen fehlenden Endpoint meldet, ist das Plugin Pipeline Graph View auf Jenkins nicht installiert.

Meldet BuildCaptain, dass der gespeicherte API-Token nicht gefunden wurde, öffne die Einstellungen und trage ihn neu ein — nur das Token-Feld musst du ausfüllen; Server und Benutzername bleiben gespeichert.

Kommst du trotzdem nicht weiter?

Die Logs-Seite zeichnet jede Anfrage mit ihrem Statuscode auf (Tokens und Antwortinhalte werden nie geloggt). Kopiere sie und schick sie uns.