Kubeterm
English | 简体中文
Kubeterm is a graphical management tool for Kubernetes clusters. It provides clear visibility into your clusters, enables users to manage cluster resources and applications easily, as well as perform troubleshooting actions.
As a locally running application, Kubeterm doesn't require anything installed into the cluster. It supports multiple platforms, including desktop and mobile devices.
Features
- Cluster Access & Authentication:
- Automatically loads the default kubeconfig with zero configuration.
- Integrates with cloud provider accounts (GCP and Azure) to import clusters by simply logging in.
- Supports cloud provider credentials, including AWS secret access keys, GCP service accounts, and Azure service principals.
- Provides built-in OIDC authentication by reading the
auth-providerfield from theusersection of the kubeconfig. Example
- AI Agent:
- Built-in AI assistant for Kubernetes troubleshooting and operations.
- Works with cluster-aware context, including the selected cluster, resource details, YAML and log snippets.
- Requires explicit approval before mutating cluster actions are executed.
- Cluster dashboard: View cluster status and live resource metrics (requires Kubernetes Metrics Server).
- Prometheus integration: Connect Prometheus for historical pod and node metrics charts. Auto-detects in-cluster instances and can reach them through the API server proxy, with no Ingress or port-forward required. Setup
- Resource Viewer: List and describe details of Kubernetes resources, including custom resources.
- Resource operations: Create, edit and delete resources, as well as advanced operations such as scaling, restart, node cordon/uncordon/drain.
- Debugging:
- Debug Node or Pod by running an ephemeral container.
- Run commands directly inside containers.
- Inspect container's logs with searching, highlighting, tailing or downloading to local.
- File transfer: Copy files from/to Pod.
- Port forwarding: Forward local requests to Pod/Service.
- Pod file browser: Open file browser on pod directly in the app.
- Helm management: Install, uninstall, upgrade and rollback Helm charts/releases.
- Cross-platform support: Available on both mobile and desktop.
- Data sync: Sync kubeconfig across multiple clients via iCloud (iOS/macOS).
Get started
Mobile version
-
Download on your mobile devices:
Desktop version (macOS, Windows and Linux)
-
Download from GitHub Releases:
-
Install macOS version by Homebrew:
brew install --cask kubeterm -
Download macOS version from App Store:
ℹ️ Note: This build runs inside Apple's App Sandbox and therefore cannot execute credential plugins (
execblocks) referenced in your kubeconfig. If you rely on these, use one of the two options above instead — the build from GitHub Releases or Homebrew is not sandboxed.
AI Agent
Kubeterm includes a built-in AI Agent for Kubernetes operations and troubleshooting. The agent runs inside Kubeterm, can work with the currently selected cluster or resource context, and helps investigate issues directly from the UI.
Security & Privacy
Kubeterm handles cluster credentials, so it's worth being explicit about where your data goes.
- Your cluster data stays on your machine. Kubeconfigs and cloud provider credentials are read and stored locally, and Kubeterm talks directly to your clusters' API servers — and, if you configure it, to your own Prometheus. There is no Kubeterm server in the path.
- No telemetry. Kubeterm collects no usage data, analytics, or crash reports.
- The AI Agent is the only outbound exception. When you use it, the context for your request goes directly from your machine to the AI provider you configured — Anthropic, OpenAI, Gemini, or DeepSeek — authenticated with your own API key.
- Mutating actions require approval. The AI Agent must ask before it runs anything that changes cluster state.
- Optional iCloud sync. If you enable kubeconfig sync on iOS/macOS, it goes through your own iCloud account. It is off unless you turn it on.
- macOS builds are signed and notarized by Apple.
FAQ
Common questions — FAQ.
Adopters
Using Kubeterm at work? Add your team to ADOPTERS.md — it helps us prioritize platforms and features, and helps others evaluating Kubeterm.
Contact us
About this repository
This repository hosts Kubeterm's issue tracker, release downloads, and documentation. The Kubeterm application is not open source.
Copyright & License
Copyright (c) 2025 kubeterm — the content of this repository is released under the MIT license.