Dashboard & Konto

Das kubehz-Dashboard (app.kubehz.cloud) ist der Ort, an dem du deine Cluster siehst, den Besitz nachweist und verwaltest, wer Zugriff hat. Dein Login und deine persönlichen Sicherheitseinstellungen befinden sich in deinem kubehz-Konto unter auth.kubehz.cloud/account.

Anmelden

Noch kein Konto? Eines anzulegen ist kostenlos und dauert etwa eine Minute. Öffne app.kubehz.cloud, wähle Konto erstellen und registriere dich mit E-Mail, Google oder GitHub. Der kostenlose Tarif umfasst bis zu zwei registrierte Cluster und braucht keine Zahlungsdaten.

Die Registrierung ist für die ersten 25 Konten offen. Danach brauchst du einen Einladungscode von einem bestehenden Konto (siehe Einladungscodes). Interne Konten und Testkonten von kubehz zählen nicht zu den 25.

Öffne app.kubehz.cloud und melde dich mit deinem kubehz-Konto an. Die Authentifizierung läuft über den eigenen Identitätsdienst von kubehz unter auth.kubehz.cloud.

Einladungscodes

Jedes Konto bekommt 2 Einladungscodes. Der Kontoinhaber findet sie unter Einstellungen → Konto im Abschnitt Deine Einladungen. Jeder Code zeigt seinen Status: Unbenutzt, Genutzt, Abgelaufen oder Widerrufen.

• Ein Code legt ein Konto an. Er funktioniert einmal.
• Ein unbenutzter Code läuft 30 Tage nach der Ausgabe durch kubehz ab.
• Die neue Person gibt den Code bei der Registrierung unter Einladungscode ein. Groß- oder Kleinschreibung ist egal, die Bindestriche sind optional.

Die Zahlen (25 Konten, 2 Codes, 30 Tage) können sich ändern.

Cluster

Liste

Nach der Anmeldung werden deine Cluster auf der Hauptseite aufgelistet, jeder zeigt seinen Namen, Status und letzten Heartbeat, sodass du auf einen Blick erkennst, was verbunden ist.

Detail

Öffne einen Cluster, um den Zustand zu sehen, den der clusterinterne Heartbeat-Agent für einen registrierten Cluster meldet:

• Kubernetes-Version: die Version, die der Cluster ausführt
• Nodes & Status: Name, Rolle und Bereitschaft jedes Nodes
• Zustand der Control-Plane-Komponenten: apiserver, etcd, scheduler, controller-manager
• Zertifikatsablauf: wann die Cluster-Zertifikate zu erneuern sind

Das sind genau die Daten, die der Agent sendet, nicht mehr. Siehe Wie es funktioniert: deine Daten.

Der verwaltete Tarif bietet mehr

Verwaltungsfunktionen (Healing-Richtlinien, Kapazitäts-Überwachung und die Verwaltung des gewünschten Zustands mit Upgrade-/Skalierungsabläufen) gehören zum verwalteten Tarif (access: managed), der live ist und ein Supporter-Abo oder höher erfordert. Einzelne ausführende Funktionen werden bewusst hinter Pro-Funktion-Schaltern ausgerollt. Für einen registered-Cluster zeigt das Dashboard den obigen schreibgeschützten Zustand.

Cluster beanspruchen

Ein neu registrierter Cluster trägt den Status Creating, bis er beansprucht ist. Die Claim-Seite verknüpft ihn mit deinem Konto und weist den Besitz nach; nach dem Beanspruchen gehört der Cluster dir. Der Ablauf ist konzeptionell registrieren → beanspruchen → besitzen; siehe Registrierung.

Zugriff

Unter Zugriff lädst du Mitglieder ein, gibst jedem eine Zugriffs-Stufe, definierst benutzerdefinierte Rollen (eine Berechtigungsmatrix, optional auf Namespaces beschränkt), wählst, für welche gehosteten Cluster der Zugriff eines Mitglieds gilt, und föderierst optional dein eigenes SSO. Auf einem gehosteten Cluster bildet sich all das direkt auf den Kubernetes-Zugriff ab.

Siehe Zugriff & Rollen für das vollständige Modell.

Unter Zugriff → Agent-Schlüssel erstellst du Schlüssel für KI-Agenten und Pipelines: siehe Agent-Schlüssel.

Einstellungen

Die Seite Einstellungen im Dashboard hat diese Tabs:

• Konto: deine Identität, der Tarif deines Kontos und deine Rolle. Der Kontoinhaber findet hier auch die Einladungscodes.
• Tenant: der Name des aktiven Tenants und die API-Ratenlimits deines Kontos.
• GitHub: Verbinde ein GitHub-Repository, damit kubehz die Abweichung zwischen deklariertem und Live-Zustand zeigen und Bootstrap-Pull-Requests öffnen kann.
• KI-Apps: Sieh, welche KI-Apps, etwa Claude oder ChatGPT, für dich handeln dürfen.
• Benachrichtigungen: Wähle, welche E-Mail-Benachrichtigungen kubehz dir schickt.
• Datenschutz: Exportiere die Daten, die kubehz über dich speichert, oder lösche dein Konto.
• Widerruf: Der Kontoinhaber sieht diesen Tab, solange ein Verbraucher noch vom Vertrag zurücktreten kann (14 Tage).

Jeder Cluster hat außerdem einen eigenen Tab Einstellungen. Projekt ordnet den Cluster einem Projekt zu, Zuschnitt ändert bei einem gehosteten Cluster die API-Server, das Zustandslimit und die Add-ons, und Cluster enthält die Verlaufseinstellung und die Schaltfläche zum Löschen.

Dein Konto (Sicherheit)

Verwalte deinen persönlichen Login unter auth.kubehz.cloud/account, der eigenen, gebrandeten Konto-Oberfläche von kubehz:

• Passwort ändern
• Zwei-Faktor-Authentifizierung: einen TOTP-Authenticator einrichten oder entfernen
• Sitzungen: aktive Sitzungen ansehen und alle widerrufen, die du nicht wiedererkennst

Fehlerbehebung

Falls ein Cluster nicht erscheint, prüfe, ob der Heartbeat-Agent vorhanden ist und auslöst:

# Ist der CronJob vorhanden und nicht pausiert?
kubectl -n kubehz-system get cronjob kubehz-heartbeat

# Logs des letzten Laufs lesen
kubectl -n kubehz-system logs -l app=kubehz-heartbeat

Ein 4xx in diesen Logs bedeutet üblicherweise, dass der Cluster nicht registriert ist (oder deregistriert wurde). Führe lo kubehz register erneut aus.

Nächste Schritte

• Registrierung: einen Self-Hosted-Cluster verbinden
• Wie es funktioniert: das Modell und deine Daten
• Gehostete Control Plane: der delegierte Weg

---

Doku-Status

Aspekt	Detail
Zustand	aktiv
Zuletzt geprüft	2026-10-30