Skip to content
Kubeterm Logo Kubeterm
Download

Cluster Management

The cluster list is the entry point to all your environments. Kubeterm loads clusters automatically and gives you multiple ways to organize them.

  • Zero Configuration: Automatically discovers and loads your default kubeconfig on desktop — no setup required after install.
  • KUBECONFIG Environment Variable: On desktop, every file listed in your KUBECONFIG environment variable is picked up as well, so the clusters you already use in the shell appear without extra setup.
  • Applications Section: Helm, Argo CD, and Flux CD are grouped under a single Applications entry in the navigation, so everything you deploy lives in one place.
  • Tags & Filtering: Assign one or more tags to any cluster (e.g. production, staging, eu-west). The cluster list shows a tab per tag so you can instantly filter to a subset. Tag suggestions are offered when you type, based on tags already in use.
  • Status Indicators: Each cluster entry shows a color-coded status (Ready / NotReady) so at-a-glance health is clear without opening the cluster.
  • Search: A search box in the cluster list filters clusters by name as you type — useful when you manage many environments.
  • Source & Location Display: The list shows where each cluster came from — kubeconfig file, AWS, Azure, GCP, DigitalOcean — along with the cloud region if available.
  • Reload kubeconfigs: A manual refresh button re-reads your local kubeconfig files to pick up any changes made outside of Kubeterm.
  • Quick Access: Pin frequently used resources across any cluster to the Quick Access section in the left navigation for one-tap navigation.
  • Multi-Tab View: Open multiple clusters or resource views simultaneously in tabs — middle-click or the context menu opens any item in a new tab.
  • Tab Keyboard Shortcuts: Switch between open tabs with keyboard shortcuts for faster navigation.
  • Cluster Actions: Right-click (desktop) or long-press (mobile) to edit tags, rename, or delete a cluster.

Cluster Settings

Each cluster has its own settings panel where you can configure:

  • Display Name: Rename a cluster for display without changing the underlying kubeconfig name.
  • Namespace Scope: Restrict the cluster view to one or more namespaces, or work across all namespaces at once.
  • Per-Cluster Proxy: Override the global proxy with a different HTTP proxy for this cluster specifically.
  • Local Authentication: Require biometric or device authentication before accessing this cluster or before performing write operations.
  • API Server Endpoint, TLS & Auth: Review and update connection details, certificate authority data, and authentication method (username/password, client cert, or bearer token).
  • Kubeconfig Editing: Open a cluster's kubeconfig in a built-in editor with word wrap and a confirmation step before saving, so small fixes don't require leaving the app.