Skip to content

Headlamp

Headlamp

Category: Infrastructure Type: Cluster Service Tags: dashboard · kubernetes · web-interface · management · monitoring · admin

Overview

Headlamp is a web-based Kubernetes dashboard that provides a clean, user-friendly interface for managing Kubernetes clusters. It allows operators and developers to view and interact with cluster resources (Pods, Deployments, Services, ConfigMaps, etc.), perform administrative tasks, and monitor cluster health — all from a browser. Headlamp is extensible via plugins and is designed as a production-ready alternative to the default Kubernetes dashboard.

How It Works

Cluster Service — Installed once per cluster by an administrator. Once active, the Headlamp dashboard is accessible at the configured URL for anyone with cluster access — no per-project installation needed.

Prerequisites

  • A DNS record pointing to your cluster's ingress controller for the Headlamp host
  • An nginx ingress controller configured in the cluster

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Headlamp"
  3. Click Install
  4. Fill in the configuration fields below
  5. Click Confirm to deploy

Configuration

Install-Time Fields

Field Details
host string · Required
Hostname for the Headlamp dashboard (e.g. headlamp.example.com). A DNS record pointing to your cluster's ingress must exist.
prefix string · Optional · Default: /
URL sub-path to mount Headlamp under (e.g. /headlamp)

Notes

  • You must create a DNS record pointing host to your cluster's ingress controller IP before the dashboard is accessible
  • Headlamp is free and open-source (Apache 2.0 license)
  • Headlamp provides read/write access to Kubernetes resources — ensure access is restricted appropriately for your environment
  • For team environments, consider configuring Headlamp with your cluster's OIDC provider for authenticated access
plugins/headlamp/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
resource_id: headlamp
name: Headlamp
icon: https://github.com/juno-fx/Terra-Official-Plugins/blob/main/plugins/headlamp/assets/logo.png?raw=true
description: Headlamp is a web-based Kubernetes dashboard that provides a user-friendly interface for managing Kubernetes clusters. It allows users to view and interact with cluster resources, perform administrative tasks, and monitor cluster health.
category: Infrastructure
tags:
  - dashboard
  - kubernetes
  - web-interface
  - management
  - monitoring
  - admin
  - cluster-level
fields:
  - name: host
    description: Connection URL. i.e. `headlamp.example.com`. Keep in mind you must set up a DNS record for this host to point to your cluster's ingress controller.
    required: true
  - name: prefix
    description: Connection URL prefix. i.e. `/headlamp`. Will default to `/` if not set.
    required: false