Den Self-hosted Runner betreiben

Standardmäßig führt kanman jede Story auf einer isolierten Maschine in Frankfurt aus. Darf Ihr Code Ihr Netz nicht verlassen, führen Sie die Codearbeit mit dem Self-hosted Runner auf Ihrer eigenen Infrastruktur aus.

So funktioniert es

Der Runner ist derselbe Executor-Host, den kanman in seiner Cloud nutzt, verpackt als Docker-Image kanman/executor-host:

• Er holt sich Arbeit. Er baut eine ausgehende HTTPS-Verbindung zu kanman auf, meldet sich an, fragt nach dem nächsten wartenden Run Ihres Workspaces und meldet die Ergebnisse zurück. Keine eingehenden Ports, kein VPN, keine Firewall-Ausnahmen für kanman.
• Er authentifiziert sich mit einem Workspace-API-Token (km_...). Er erhält nie Datenbank-Zugangsdaten. Jeder Run, den er übernimmt, bekommt ein eigenes Run-Token, das mit dem Ende des Runs ungültig wird.
• Für jeden Run klont er das Repository, legt den Run-Branch an, startet den Coding-Agenten mit dem Auftrag des Runs und dem kanman-MCP und meldet Fortschritt, die Diff-Zusammenfassung, die Commits und ein Protokoll der Arbeit des Agenten.
• Der Checkout des Repositorys bleibt auf Ihrer Maschine.

Was der Modellanbieter erhält, beschreibt Was Modellanbieter sehen. Der Coding-Agent ruft den Anbieter vom Runner aus auf, mit dem Schlüssel, den Sie dem Runner mitgeben, oder bei Teams mit eigenem Schlüssel mit diesem Schlüssel.

Voraussetzungen

• Ein Linux-Host oder eine VM mit Docker. Der Runner braucht CPU und Speicher wie ein CI-Job für Ihr Repository.
• Ausgehendes HTTPS zu kanman, zu Ihrem Git-Host und zu Ihrem Modellanbieter.
• Ein Schlüssel beim Modellanbieter für die Executors, die der Runner anbietet: ANTHROPIC_API_KEY für Claude Code, OPENAI_API_KEY für Codex. Für Teams, die in kanman einen eigenen Schlüssel nutzen, nicht nötig; ihr Schlüssel kommt mit dem Run.

Schritt 1: Ein Token anlegen

1. Öffnen Sie Einstellungen > API und klicken Sie auf Token erstellen.
2. Benennen Sie es nach dem Runner, zum Beispiel runner-fra-1.
3. Wählen Sie eine Laufzeit (30 Tage, 90 Tage oder 1 Jahr), die zu Ihrer Rotationsrichtlinie passt. Der Runner braucht keine bestimmte Berechtigung; jedes aktive Token des Workspaces funktioniert.
4. Kopieren Sie das Token. Es wird nur einmal angezeigt.

Schritt 2: Den Runner starten

Einstellungen > Runner zeigt den Befehl zum Kopieren. Mit Namen und beiden Executors sieht er so aus:

docker run -d --name kanman-runner \
  --restart unless-stopped \
  -e KANMAN_API_KEY=km_ihr_runner_token \
  -e ANTHROPIC_API_KEY=ihr_anthropic_schluessel \
  -e RUNNER_NAME=runner-fra-1 \
  -e RUNNER_EXECUTORS=claude-code,codex \
  -e OPENAI_API_KEY=ihr_openai_schluessel \
  kanman/executor-host

Pinnen Sie das Image in Produktion auf eine Versionsnummer und aktualisieren Sie bewusst.

Schritt 3: Den Status prüfen

Öffnen Sie Einstellungen > Runner. Der Runner erscheint mit Name, Executors, Version, dem Zeitpunkt, zu dem er zuletzt gesehen wurde, und seinem Status. Die Liste aktualisiert sich alle 30 Sekunden:

Schritt 4: Arbeit an Ihre Runner schicken

Die Wahl gilt für den ganzen Workspace. Öffnen Sie Einstellungen > KI-Anbieter, klappen Sie Advanced auf und schalten Sie Kanman Cloud aus. Ab dann gehen wartende Runs aller Teams an Ihre Runner und werden der Reihe nach übernommen. Einstellungen > Runner bestätigt, wo Runs ausgeführt werden. Die Parallelität richtet sich weiter nach der Richtlinie jedes Teams und seinem Tarif.

Skalieren und aktualisieren

• Mehr Kapazität: Starten Sie weitere Runner mit anderen Namen, oder erhöhen Sie RUNNER_CONCURRENCY auf einem größeren Host.
• Aktualisieren: Stoppen Sie den Container mit genug Zeit für seine Runs, zum Beispiel docker stop --time 1800 kanman-runner. Beim Stoppen zeigt der Runner Beendet laufende Arbeit, schließt seine Runs ab und geht offline. Starten Sie dann die neue Version.
• Token rotieren: Legen Sie ein neues Token an, starten Sie den Runner damit neu und widerrufen Sie dann das alte. Ein widerrufenes oder abgelaufenes Token nimmt den Runner offline.

Fehlerbehebung