# Headlamp

An extensible Kubernetes desktop interface for browsing and managing multiple clusters with your existing credentials and RBAC permissions.

> This is the Markdown version of the Headlamp page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/headlamp>

- **Latest version**: `0.46.0`
- **Developer**: Kubernetes SIG UI
- **Homepage**: <https://headlamp.dev/>
- **Categories**: [Virtualization & Containers](https://opennavo.com/categories/virtualization)
- **Install**: `brew install --cask headlamp`
- **30-day installs**: 1,207
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/headlamp-k8s/headlamp/releases/download/v0.46.0/Headlamp-0.46.0-mac-arm64.dmg>
- **SHA-256**: `20294a2f1e92aa98c2a90aa0717b6b8e730ed55a0300c03db18c2f779ed7b564`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "com.kinvolk.headlamp"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Headlamp.app"
      ],
      "target": "/Applications/Headlamp.app"
    },
    "phase": "install",
    "sources": [
      "Headlamp.app"
    ],
    "target": "/Applications/Headlamp.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/Headlamp",
            "~/Library/Logs/Headlamp",
            "~/Library/Preferences/com.kinvolk.headlamp.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Headlamp is an open-source Kubernetes interface for developers, platform engineers and cluster administrators. Browse workloads, nodes, storage and networking; inspect resource details and logs; open pod terminals; and create or edit resources when your cluster permissions permit.

### Desktop and in-cluster editions
This package installs Headlamp.app on your Mac. It connects to existing Kubernetes API servers using kubeconfig and their authentication mechanisms. It does not install Kubernetes or create a cluster. Headlamp can also be deployed as a web application inside a cluster, but that is a separate deployment rather than a requirement for this desktop app. Multiple clusters can be selected from one interface.

### Installation and requirements
The Mac package supports Apple Silicon and Intel through separate DMG downloads; the cask requires macOS 12 or newer. Copy the application from the DMG to Applications. The 0.45.0 Apple Silicon DMG is 143,705,681 bytes; Intel downloads and installed size differ. Direct downloads are updated by downloading and replacing the app; Homebrew can manage cask upgrades.

Provide a valid kubeconfig, normally in the default Kubernetes configuration location, and network access to the API server. Certificates, tokens, cloud authentication helpers and any VPN or proxy required by your cluster remain necessary. The cask declares no additional package dependencies or conflicts. kubectl is useful for preparing and diagnosing cluster access, but is not declared as a cask dependency; authentication executables referenced by your kubeconfig must be available separately.

### Permissions and extensions
Kubernetes RBAC determines what can be viewed, edited, scaled or deleted. Limited namespace permissions may require configuring accessible namespaces. Headlamp is an interactive management tool, not a read-only monitor: authorized edits, pod execution and deletion can affect real workloads and data. Protect kubeconfig credentials and use appropriately limited access.

The Plugin Catalog offers installable extensions. Some require additional software in the cluster, such as Flux. Plugin publisher badges are provenance indicators, not security audits. Review plugin code, permissions and maintenance before installation: extensions can access cluster capabilities and desktop command facilities, so install only trusted code. Desktop command consent and other protections do not make arbitrary plugins harmless.

### License and costs
Headlamp is maintained by the Kubernetes SIG UI community and distributed under Apache License 2.0, free for personal and commercial use. The desktop app has no separate Headlamp subscription or mandatory Headlamp account. Cluster credentials are still required, and hosted Kubernetes, cloud services or third-party integrations can have their own accounts and charges.

## System requirements

- macOS 12 or later · Version: 0.46.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · Checked 2026-11-22
  - <https://github.com/headlamp-k8s/headlamp/releases/download/v0.46.0/Headlamp-0.46.0-mac-x64.dmg>
  - SHA-256: `946c72185732295fefe48e52efdb210a029eaa3fc443813bc8cbbb81b05f87ac`
- macOS 12 or later · Version: 0.46.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · Checked 2026-11-22
  - <https://github.com/headlamp-k8s/headlamp/releases/download/v0.46.0/Headlamp-0.46.0-mac-arm64.dmg>
  - SHA-256: `20294a2f1e92aa98c2a90aa0717b6b8e730ed55a0300c03db18c2f779ed7b564`

## Headlamp security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/kubernetes-sigs/headlamp> · Open source: Yes — <https://github.com/kubernetes-sigs/headlamp> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask headlamp`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask headlamp`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/Headlamp` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Logs/Headlamp` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.kinvolk.headlamp.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 0.46.0 (2026-10-15)

Adds alpha Kubernetes Dynamic Resource Allocation views, hierarchical workloads, Job suspend/resume and a configurable details drawer. Port forwards reconnect after pod restarts. Improves OIDC, plugin credential isolation, accessibility and localization.

Adds alpha Kubernetes Dynamic Resource Allocation views, hierarchical workloads, Job suspend/resume and a configurable details drawer. Port forwards reconnect after pod restarts. Improves OIDC, plugin credential isolation, accessibility and localization.

[Official source](https://github.com/kubernetes-sigs/headlamp/releases/tag/v0.46.0)

## Facts and sources

- <https://opennavo.com/apps/headlamp>
- <https://opennavo.com/apps/headlamp/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/headlamp>
- <https://github.com/kubernetes-sigs/headlamp> · Checked 2026-11-13
