# Headlamp

Headlamp is an easy-to-use and extensible web UI for viewing and managing Kubernetes clusters, whether they run in-cluster or locally. It is open source and self-hosted, installable on Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/4673/headlamp

## Description

Headlamp is an easy-to-use and extensible web UI for viewing and managing Kubernetes clusters, whether they run in-cluster or locally. It lets you list and inspect resources, workloads, and pods, and extends with plugins for added functionality. It suits self-hosters who want a vendor-independent Kubernetes dashboard.

## Platform availability

Available on 4 of 10 platforms: Helm, Mac, Windows, Linux.

## Desktop and other devices

Mac, Windows, Linux.

## Health score

83/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 78 (7,661 GitHub stars)
- Easy to install: 55 (4 install platforms, install notes)

## Links

- desktop: https://github.com/kubernetes-sigs/headlamp/releases/latest
- Kubernetes (Helm): https://artifacthub.io/packages/helm/headlamp/headlamp
- GitHub: https://github.com/kubernetes-sigs/headlamp
- Official website: https://headlamp.dev/
- Documentation: https://headlamp.dev/docs/latest/

## Common questions

### Do I usually need an ingress when deploying Headlamp in-cluster?

For a common in-cluster deployment, you set up an ingress server so users can reach the Headlamp web UI.

### Can the Headlamp desktop app manage clusters that are not deployed in-cluster?

Yes, the desktop app can be used to manage unrelated clusters locally instead of deploying Headlamp in a cluster.

### Why might Headlamp not show cluster resources correctly after I log in with a token?

Headlamp uses RBAC to check access, so a token with limited permissions may not display resources correctly. Use a Service Account token with sufficient permissions.

### Where are the container images hosted after the project moved to kubernetes-sigs?

The project moved under the kubernetes-sigs organization, but the container images remain at ghcr.io.

### What should I cover when migrating from Kubernetes Dashboard to Headlamp?

The migration guide covers installation, RBAC, multi-cluster use, daily workflows, and cleanup.

### Why do I see warnings when running Headlamp desktop apps on macOS or Windows?

The desktop apps are unsigned, so macOS and Windows may show warnings when running them.

## Alternatives

- Aptakube: A modern, lightweight and multi-cluster desktop client for Kubernetes.
- Freelens: Freelens is a free and open-source user interface designed for managing Kubernetes clusters.
- K9s: K9s is a terminal based UI to interact with your Kubernetes clusters.
- Lens K8S IDE: Lens is the most powerful Kubernetes IDE on the market.
- Radar UI: Open-source Kubernetes interface for humans and AI agents — topology, events, Helm, GitOps, image internals, and audits from a single binar…
- Spinoza: Spinoza is a local, source-available Kubernetes IDE that brings cluster resources, Helm, live YAML editing, logs, port-forwarding, and Flux…
- k8studio: K8Studio is a graphical integrated development environment (IDE) for Kubernetes that simplifies cluster and workload management with a visu…

---
Source: Our Local Host (https://ourlocalhost.com/app/4673/headlamp), the self-hosted and open-source app directory.
