Headlamp — Extensible Open-Source Kubernetes Web UI
CNCF Sandbox Kubernetes dashboard — desktop app or self-hosted web UI with a plugin API, multi-cluster support, and OIDC.
What it is
Headlamp is an extensible open-source Kubernetes dashboard that runs as a desktop app or self-hosted web UI. It is a CNCF Sandbox project that provides a clean interface for managing Kubernetes clusters with a plugin API for custom extensions.
The tool targets DevOps engineers, platform teams, and developers who want a lightweight, customizable alternative to the default Kubernetes Dashboard. It supports multi-cluster management and OIDC authentication out of the box.
How it saves time or tokens
Headlamp replaces kubectl commands with a visual interface for common operations: viewing pods, deployments, services, and logs. The plugin API lets teams add custom views for their specific workflows without forking the project. Multi-cluster support eliminates switching kubectl contexts manually.
How to use
- Install the desktop app from the Headlamp releases page, or deploy to your cluster with Helm:
helm install headlamp headlamp/headlamp. - Connect to your cluster using your existing kubeconfig.
- Browse resources, view logs, and manage workloads through the web UI.
Example
# Install via Helm
helm repo add headlamp https://headlamp-k8s.github.io/headlamp/
helm install headlamp headlamp/headlamp -n headlamp --create-namespace
# Access the dashboard
kubectl port-forward -n headlamp svc/headlamp 4466:80
# Open http://localhost:4466
# Or install the desktop app
brew install --cask headlamp # macOS
Related on TokRepo
- AI Tools for DevOps -- DevOps and infrastructure management tools
- Featured Workflows -- discover popular developer tools and utilities
Common pitfalls
- Headlamp requires RBAC permissions matching your kubeconfig. If you see empty resource lists, check your ClusterRole bindings.
- The plugin API uses React components. Building custom plugins requires frontend development knowledge.
- For production self-hosted deployments, always configure OIDC or token-based authentication. The default setup may expose cluster access without proper auth.
Frequently Asked Questions
Headlamp offers a plugin API for custom extensions, multi-cluster support, and OIDC authentication. The default Kubernetes Dashboard is simpler but less extensible. Headlamp is also a CNCF Sandbox project with active community development.
Yes. Headlamp can connect to multiple Kubernetes clusters simultaneously. You switch between clusters in the UI without changing kubectl contexts or kubeconfig files.
Yes. Headlamp provides a plugin API based on React components. You can add custom views, sidebar items, and resource displays. Plugins are loaded at runtime without rebuilding the main application.
Yes. Headlamp is open source under the Apache 2.0 license. It is a CNCF Sandbox project with no commercial restrictions.
Yes. Headlamp works with any Kubernetes cluster including EKS, GKE, AKS, and self-managed clusters. It connects using standard kubeconfig credentials.
Citations (3)
- Headlamp GitHub— CNCF Sandbox Kubernetes dashboard
- Headlamp Plugin Docs— Plugin API for custom extensions
- CNCF Headlamp Page— CNCF Sandbox project status
Related on TokRepo
Discussion
Related Assets
NAPI-RS — Build Node.js Native Addons in Rust
Write high-performance Node.js native modules in Rust with automatic TypeScript type generation and cross-platform prebuilt binaries.
Mamba — Fast Cross-Platform Package Manager
A drop-in conda replacement written in C++ that resolves environments in seconds instead of minutes.
Plasmo — The Browser Extension Framework
Build, test, and publish browser extensions for Chrome, Firefox, and Edge using React or Vue with hot-reload and automatic manifest generation.