Headlamp Headlamp
winget install --id=Headlamp.Headlamp -e A Kubernetes web UI that is fully-featured, user-friendly and extensible.
Headlamp: A Comprehensive Kubernetes Web UI
Headlamp is a fully-featured, user-friendly, and extensible Kubernetes web interface designed to simplify the management and monitoring of clusters. It offers a seamless experience for users by combining traditional dashboard functionalities with advanced features.
Key Features:
- Multi-cluster Management: Efficiently handle multiple environments from a single interface.
- Extensibility via Plugins: Customize your workflow with plugins tailored to specific needs.
- Role-Based Access Controls (RBAC): Ensure secure access and permissions management.
- Modern UI with Interactive Operations: Intuitive design enhances user experience, making resource management more efficient.
Audience & Benefit: Ideal for Kubernetes administrators, developers, and DevOps engineers, Headlamp streamlines cluster management by providing a unified dashboard. It simplifies resource monitoring and operations, allowing users to focus on their tasks without needing additional tools.
Installation: Headlamp can be easily installed via winget, ensuring quick setup and integration into your environment.
This description is crafted to highlight the essential aspects of Headlamp, focusing on its benefits and features without unnecessary embellishments.
README
<img src="frontend/src/resources/logo-dark.svg" />
<img src="frontend/src/resources/logo-dark.svg" />
> NOTICE: We have recently moved the project under the Kubernetes SIG UI (and the repo under the kubernetes-sigs org). Container images are still at ghcr.io. Please bear with us while we may experience some broken links.
Headlamp is an easy-to-use and extensible Kubernetes web UI.
Headlamp was created to blend the traditional feature set of other web UIs/dashboards (i.e., to list and view resources) with added functionality.
Features
- Vendor-independent / generic Kubernetes UI
- Works in-cluster, or locally as a desktop app
- Multi-cluster
- Extensible through plugins
- UI controls reflecting user roles (no deletion/update if not allowed)
- Clean & modern UI
- Cancellable creation/update/deletion operations
- Logs, exec, and resource editor with documentation
- Read-write / interactive (actions based on permissions)
Screenshots
<img src="https://raw.githubusercontent.com/kubernetes-sigs/headlamp/screenshots/screenshots/home.png" />
<img src="https://raw.githubusercontent.com/kubernetes-sigs/headlamp/screenshots/screenshots/cluster_chooser.png" />
<img src="https://raw.githubusercontent.com/kubernetes-sigs/headlamp/screenshots/screenshots/workloads.png" />
<img src="https://raw.githubusercontent.com/kubernetes-sigs/headlamp/screenshots/screenshots/resource_edition.png" />
<img src="https://raw.githubusercontent.com/kubernetes-sigs/headlamp/screenshots/screenshots/logs.png" />
<img src="https://raw.githubusercontent.com/kubernetes-sigs/headlamp/screenshots/screenshots/terminal.png" />
Quickstart
If you want to deploy Headlamp in your cluster, check out the instructions on running it in-cluster.
If you have a kubeconfig already, you can quickly try Headlamp locally as a desktop application for Linux, Mac, or Windows. Make sure you have a kubeconfig file set up with your favorite clusters and in the default path so Headlamp can use it.
Accessing
Headlamp uses RBAC for checking users' access to resources. If you try Headlamp with a token that has very limited permissions, you may not be able to view your cluster resources correctly.
See the documentation on how to easily get a Service Account token for your cluster.
Tested platforms
We maintain a list of the Kubernetes platforms we have tested Headlamp with. We invite you to add any missing platforms you have tested, or comment if there are any regressions in the existing ones.
Extensions / Plugins
Please see headlamp plugins on Artifact Hub for a list of plugins published.
See the plugins repo for some official plugins.
Plugin development
If you are interested in tweaking Headlamp to fit your use-cases, you can check out our plugin development guide.
Get involved
Check out our:
- Guidelines
- Code of Conduct,
- #headlamp slack channel in the Kubernetes Slack
- Monthly Community Meeting
Roadmap / Release Planning
If you are interested in the direction of the project, we maintain a Roadmap. It has the biggest changes planned so far, as well as a board tracking each release.
License
Headlamp is released under the terms of the Apache 2.0 license.
Frequently Asked Questions
For more information about Headlamp, see the Headlamp FAQ.