Uninstall Headlamp on Mac

Keep Kubernetes kubeconfig files and any plugin settings you intend to reuse; Headlamp reads cluster configuration but does not own the cluster. The September 19, 2026 record covers the app copied from the official package.

Quit and remove the app

Disconnect from clusters, quit Headlamp and its headlamp-server process, then move Headlamp.app to Trash. Do not remove kubeconfig files or cluster resources as part of this step. The official page has more product information.

Review the app’s data

The cask lists ~/Library/Application Support/Headlamp, ~/Library/Logs/Headlamp and an older com.kinvolk.headlamp preference. Review Application Support for local plugin state before removing it; cluster credentials may live in a separate kubeconfig.

If you installed it with Homebrew

The Homebrew cask has its own --zap list. brew uninstall --cask headlamp removes the cask without that list; brew uninstall --cask --zap headlamp also acts on its listed data without consulting Mole’s checkboxes. Zap includes the display-name Application Support folder; inspect plugin state first. Mole also suppresses zap if its list would cross an unchecked, shared, unknown, or unsupported path; selected remnants still follow Mole’s own deletion path.

brew uninstall --cask headlamp

Check the result

These commands inspect the running process and one relevant location. They do not remove anything:

pgrep -il "Headlamp"
ls -ld "$HOME/Library/Application Support/Headlamp"

No pgrep match means no process with that name is running; a match needs identification before quitting anything. A listed path still exists, while an ls “No such file” error means only that exact path is absent. A permission error is inconclusive.

What Mole lists

Mole lists display-name Application Support/Headlamp for review and leaves it unchecked. Exact bundle-ID rows are selected only when ownership is verified; it does not take a kubeconfig merely because Headlamp used it.

What this test covered

The test used the app copied from the official package. On September 19, 2026, seven Headlamp processes were grouped into one Status row. The display-name Application Support folder appeared as an unchecked review item and was not in that removal plan; no cluster deletion was tested.