A lightweight, open-source Kubernetes dashboard for managing multiple clusters, with monitoring, RBAC access control and an AI troubleshooting assistant.
kubernetes-sigs/headlamp
An easy-to-use, extensible Kubernetes web UI for listing, viewing and managing cluster resources, runnable in-cluster or as a desktop app.
Open-source alternative to:Lens
Kubernetes Dashboard
- Stars
- 7,580
- Forks
- 1,211
- Open issues
- 1,575
- Last commit
- yesterday
What is it?
Headlamp is a web UI for Kubernetes that combines the usual dashboard features of listing and viewing resources with actions such as editing, logs, exec sessions and resource creation, deletion and updates. It is vendor-independent and can manage multiple clusters from one interface.
Headlamp can be deployed inside a cluster or run locally as a desktop application on Linux, macOS or Windows, using an existing kubeconfig. Access follows Kubernetes RBAC, so the UI hides or disables actions the current user is not permitted to perform.
Its functionality can be extended through plugins, and a plugin development guide and a catalog of published plugins on Artifact Hub are available.
Key features
- 01Vendor-independent Kubernetes web UI that works with multiple clusters.
- 02Runs in-cluster or locally as a desktop app for Linux, macOS and Windows.
- 03Shows logs, exec terminals and a resource editor for cluster objects.
- 04Hides or disables create, update and delete actions based on user RBAC permissions.
- 05Extensible through a plugin system with plugins published on Artifact Hub.
Use cases
- Browsing and debugging workloads, pods and logs in a Kubernetes cluster.
- Giving team members role-limited read or write access to cluster resources through a web UI.
- Managing several clusters from a single desktop application.
- Building custom views or tools for a specific platform through plugins.
Quick start
- 1
Deploy Headlamp in your cluster using the in-cluster instructions
- 2
Install the desktop app for Linux, Mac or Windows
- 3
Make sure a kubeconfig file with your clusters is in the default path
Things to know
- Access is governed by RBAC, so a token with limited permissions may hide cluster resources.
In collections
Topics
FAQ
- What is headlamp?
- An easy-to-use, extensible Kubernetes web UI for listing, viewing and managing cluster resources, runnable in-cluster or as a desktop app. Headlamp is a web UI for Kubernetes that combines the usual dashboard features of listing and viewing resources with actions such as editing, logs, exec sessions and resource creation, deletion and updates. It is vendor-independent and can manage multiple clusters from one interface.
- Is headlamp free to use? What license does it have?
- headlamp is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is headlamp still maintained?
- Actively maintained. The last commit to headlamp was on Nov 6, 2026.
- What can I use headlamp for?
- Browsing and debugging workloads, pods and logs in a Kubernetes cluster. Giving team members role-limited read or write access to cluster resources through a web UI. Managing several clusters from a single desktop application. Building custom views or tools for a specific platform through plugins.
- How do I install headlamp?
- Deploy Headlamp in your cluster using the in-cluster instructions Install the desktop app for Linux, Mac or Windows Make sure a kubeconfig file with your clusters is in the default path
- Where can I get headlamp?
- The source code and installation instructions are on GitHub: https://github.com/kubernetes-sigs/headlamp
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A real-time logging dashboard for Kubernetes that merges logs from all containers in a workload into one timeline, in a browser or terminal.
A free, open-source native desktop Kubernetes IDE built with Tauri and Vue, combining keyboard shortcuts with a polished UI for multiple clusters.
Open source container management platform for running Kubernetes clusters across many environments in production.
k0s is a single-binary, all-inclusive Kubernetes distribution that aims to make cluster setup and upgrades simple on any Linux host.
A desktop Kubernetes client built with Tauri and Rust that reads your kubeconfig and derives status the way kubectl does.