Dashboard & Konto

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

Anmelden

Ö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.

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 (Upgrade-/Skalierungsabläufe) — 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 erscheint als pending. 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.

Team

Unter Team 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 Team & Rollen für das vollständige Modell.

Einstellungen

Cluster- und Organisationseinstellungen ermöglichen es dir, den Anzeigenamen eines Clusters umzubenennen, seinen Verbindungsstatus zu prüfen und ihn aus dem Dashboard zu deregistrieren, wenn du keine Sichtbarkeit mehr wünschst.

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 (Early Access)

---

Doku-Status

Aspekt	Detail
Zustand	aktiv
Zuletzt geprüft	2026-07-16