headlamp

Headlamp is an easy-to-use and extensible Kubernetes web UI.

✨ Enhancements:

• Add plugin catalog to easily install plugins from ArtifactHub
• Add UI for easily creating a namespace
• Add cluster renaming feature
• Add navigation menu to app, so users can go back/forth in history (desktop only)
• Replace icon for the Deployment/ReplicaSet scale action with a more intuitive one
• Hide non-editable fields when editing in CustomResources (thanks to @Guilamb )
• Charts from the Workloads now have a link to their respective workload pages

New plugin catalog:

🐞 Bug fixes

• Fix release notes viewer
• Add auth header only if token exists (thanks to @LudovicTOURMAN )
• Fix imagePullSecrets in value schema
• Allow editor to auto-resize to adapt to the window size
• Fix reduced motion styling
• Fix visibility for scale action (in Deployment/ReplicaSet)
• Do not allow negative values in the scale UI
• Fix use of scaling requests when user cannot update the resource
• Fix showing successful popup when editor operations were not successful

💻 Development

• Replace deprecated create-react-app with vite
• Bump dependencies both in Dockerfile, frontend, backend, and plugins
• Add plugin management capabilities to app
• Increase more testing coverage
• Add signing of Helm charts
• Add i18n test coverage to CI
• Allow passing namespace to testAuth function
• Replace minikube with kind in CI

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.25.0
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

🐞 Bug fixes

• Fix viewing the Network > Services page when there are services without ports
• Fix top bar and sidebar on small screens (thanks to @tazo90 )
• Fix misc regressions in several components
• Do not log errors related to OIDC when OIDC is not set up
• Remove mistakenly added package*.json files from root folder
• Fix hiding back link when it's set as null
• charts: Fix wrong OIDC external secret loading
• charts: Fix config.extraArgs and env values type
• charts: Fix ingress (thanks to @BlindB0 )

💻 Development

• chart: Add schema for values
• Make KubeService.spec.ports as optional in interface
• Update some dependencies

📖 Documentation

• Fix link to FAQ in README
• chart: Add example docs for ingress

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.24.1
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

✨ Enhancements:

• New table (powered by material-react-table) which supports column filtering and a more comprehensive search by table values
• Misc improvements to the node views. Thanks to @farodin91 .
• Add exit code, started/finished dates, and last state details to the containers' view
• Ships app-catalog plugin version 0.2.0, which displays CNCF, official, and verified badges on charts,
  for a quicker check for verified versions of charts
• Add categories to the CustomResourceDefinition's list and details view. Thanks to @Guilamb .

Example of the new table in the Pods list:

🐞 Bug fixes

• Fix contrast issue for "upload kubeconfig" button. Thanks to @gaojinhua
• Fix displaying container status for successful containers (they were shown as errors)
• Fix broken StatefulSet list view (unreleased bug). Thanks to @yuriscott .
• Fix sudden opening of a URL internal to the app in the system's browser under certain scenarios
• Fix deleting/editing CustomResourceDefinitions
• Fix running external auth from kubeconfig (e.g. kubelogin)
• Fix issue in running certain APIs with older versions of Kubernetes. Thanks to @msuret .

💻 Development

• Misc security updates for dependencies
• Finish porting all the styling to sx for styling components. Thanks to @farodin91 .
• Fix run-backend/frontend on Windows CLI
• Add Winget PR automation (through CI)
• Add chart template tests
• Add more options to OIDC configuration for charts.
• Add ingressClassName to Ingress template. Thanks to @ccolic .
• Add the ability to pass extra args to the chart
• Change default plugin directory, to not mess up where plugins are read from when running Headlamp in dev mode

📖 Documentation

• Update go and node minimum required versions
• Add FAQ section
• Include Azure in platforms. Thanks to @shivamagnihotri .
• Update Playwright docs
• Add docs on running Headlamp in EKS with Cognito

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.24.0
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

🐞 Bug fixes

• Fix opening external URL (was opening within the app)
• Use the right creation date for events
• Use the event series' dates when they exist
• Fix success state when adding clusters from a kubeconfig file
• Fix issue with copying the git folder when building the OCI image
• Fix warning when running npm start in the frontend folder
• Fix plugin paths when base URL is set

💻 Development

• Misc security updates for all modules, including the example plugins
• Fix types in apiProxy
• Adjust permissions, auth, and steps in Github Actions

📖 Documentation

• Fix the link in building plugin page

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.23.2
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

🐞 Bug fixes

• Disable notifications temporarily, till we fix related performance issues
• Fix deleting a cluster
• Fix order of workload charts (to match the order of the sidebar items); thanks to @r0b2g1t
• Fix showing the warnings by default, in the cluster overview

💻 Development

• e2e tests: Fix flaky test to wait for page to load
• CI: Cache build container build for faster testing
• Update frontend and backend dependencies
• Update dependencies for example plugins

📖 Documentation

• Update required go and node versions

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.23.1
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

(See possible logs related breaking change at the bottom)

✨ Enhancements:

• Support user-specific clusters even in shared environments
  • Allows for users to set up clusters in a shared Headlamp deployment, without other users seeing the clusters
• Add the possibility for plugins to declare/show their own settings
• Add the number of warnings for each cluster in the Home view
• Improved notifications list page UI
• Show a chart about the nodes in the cluster overview (thanks to @farodin91 )
• Reorder entries in the sidebar for something more logical (thanks to @farodin91 )
• Improve how the OIDC token expiration is handled in the backend
• Rename Storage Volumes as Persistent Volumes (thanks to @farodin91 )
• Add link to the Volume Claim details view, for the respective Storage Class (thanks to @farodin91 )
• Add link to the Volume details view, for the respective Storage Class (thanks to @farodin91 )
• Add option to view/download all the logs in the log viewer
• Improve WebSocket connection handling
• Add confirmation dialog for the node drain action
• Add a way for plugins to react to miscellaneous Headlamp events (events like resource events loaded, plugins loaded, error bound hit, etc.)
• Allow to delete plugins from the UI (desktop version only)
• Enable the plugin settings view also in web
• Show a notification when there are incompatible (and thus automatically disabled) plugins
• Include LimitRange and ResourceQuota in the Namespace details view (thanks to @farodin91 )

New ready nodes chart in the cluster overview

Warning when an incompatible plugin is installed

Settings for a plugin (the change-logo example one)

🐞 Bug fixes

• Misc warning fixes related to React (thanks to @farodin91 )
• Fix issue related to starting an action in a cluster and then quickly moving to another cluster
• Fix missing icon tests
• Fix performance related issues in notifications
• Fix default sorting in resource tables
• Fix notifications not getting events unless when in a cluster context
• Fix resource restart annotation (thanks to @farodin91 )
• Fix copying plugins to container (and fix the related tests)

🧱 Shipped Plugins

• Update Prometheus plugin version to 0.1.0

💻 Development

• Update example plugins to headlamp-plugin 0.8.0
• Storybook upgraded to 7.6.7
• Update Github Actions' version (thanks to @farodin91 )
• More stories for different resources (thanks to @farodin91 )
• Add support for a hideColumns property in the ResourceTable component
• Fix BackLink component exportation
• Add an example of how to set up plugin settings in the change-logo and pod-counter apps
• Add the ability to specify the cluster in the API related functions
• Add a lot of test coverage, including new load tests
• Allow to hide the search filter in the SectionFilterHeader component (thanks to @farodin91 )
• Start migrating MUI styles to the sx property in preparation for React 18 (thanks to @farodin91 )
• Add new headlamp-events example plugin

📖 Documentation

• Fix documentation about Keyclock
• Add tests on load testing
• Add link to Helm quickstart
• Add article about using OIDC with Minikube and Dex
• Add link to container plugins' blog post

🔨 (Possible) Breaking Change

• The backend logs are now by default using structured logging

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.23.0
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

Headlamp is an easy-to-use and extensible Kubernetes web UI.

Headlamp is an easy-to-use and extensible Kubernetes web UI.

Important: This version of Headlamp updates the whole UI to MUIv5 and requires the plugins to do the same and to use headlamp-plugin 0.8.0-alpha.3 or later. Plugins that have not been built using this version of headlamp-plugin will not be enabled. Check out the docs on how to upgrade the plugins.

✨ Enhancements:

• Update to Material UI v5
• Add VerticalPodAutoscalers
• Add IngressClass, thanks to @farodin91
• Ship the Prometheus plugin in the container image
• Add checks for incompatible plugins and report that to the user (desktop only)
• Reset workloads when the cluster is changed, so it's more easily noticeable that things have been updated
• Show first/last pages in the table pagination, thanks to @farodin91
• Use the kubeconfig-defined namespace as the default namespace for a cluster
• Improve the information for the persistent volumes in the pod details view

New Vertical Pod Autoscalers section

New Volume details in the Pod details view

🐞 Bug fixes

• Fix starting portforwarding in the list view
• Fix circular imports in frontend's lib
• Remove the left padding when in a small screen
• Apply limits (if requested) to the streams when streaming data about a list
• Fix duplicated HTML IDs
• Stop processing proxied request if the proxy matching failed
• Use details grid for the Node details, and ActionButton for the Pod details view, thanks to @farodin91
• Do not show namespaces in the job list under CronJob, thanks to @farodin91
• Show namespace filter in the workloads list, thanks to @farodin91

💻 Development

• New tests for portforwarding
• Refactor all Redux related to Redux Toolkit
• Add new e2e tests
• Export the ResourceListView and AuthVisible components (so plugins can use them), thanks to @farodin91
• Add support for custom base image (and Debian-based base images) when building the container image
• Add getCRClass method to the CustomResourceDefinition class, for easily getting CRs

📖 Documentation

• New docs for running Headlamp in a minikube cluster with KeyCloak OIDC auth
• Fix typo in the platforms section, thanks to @stefkiourk

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.22.0
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.

Headlamp is an easy-to-use and extensible Kubernetes web UI.

📣 User Research Survey 🚊
We are looking for people who use Kubernetes to share their feedback and insights with us. Whether you use Headlamp or not, we want to hear from you! Your input will help us improve Headlamp and make it more useful for the open source community.
If you are interested, please fill out this short survey ✨ Headlamp User Research ✨ It will only take a few minutes of your time. If you are willing to do an interview with our UX team, please indicate that in the survey and provide your contact information. We will reach out to you to schedule a 45-minute interview at your convenience. Thank you for your interest and support. We hope to hear from you soon!

✨ Enhancements:

• Show Prometheus powered time-based charts in workloads' details views
• Show loaders (spinners) in the workloads overview page
• Allow to choose ephemeral and init containers when viewing logs
• Allow to exec into ephemeral and init containers
• Add a section to show ephemeral containers in the pod details view
• Add a timestamp to the logs download file

🐞 Bug fixes

• Fix format and format check scripts to use the same source list
• Fix issue in PersistentVolumeClaims when the volumeName is missing
• Fix styling in Endpoints's addresses in the details view
• Misc dependency updates
• Fix diplaying the statuses for init containers
• Fix checking permissions using KubeObject.getAuthorization (thanks to @Denis220795 for testing)
• Jobs spawned manually from CronJobs now have the latter has their owner reference

💻 Development

• Add i18n related tests
• Simplify how i18n is done (only glossary and translation namespaces now)
• Add utility tools for extracting and copying translations
• Add a new ErrorPage component
• Refactor the plugins logic in the backend
• Add more tests to the frontend and backend
• Update how the app is notarized for Mac
• Fix missing return in a function in endpoints.ts (thanks to @Src0p )
• Allow DetailsGrid users to be aware when its resource has changed

📖 Documentation

• Add API docs to different modules related to the frontend API
• Add docs about Winget installation

Container image: 🐳 ghcr.io/headlamp-k8s/headlamp:v0.21.0
Desktop Apps:

🐧 Flatpak / Linux (AMD64)
🐧 Linux AppImage AMD64, ARM64, ARMv7l
🐧 Linux Tarball AMD64, ARM64, ARMv7l
🐧 Debian / Linux AMD64
🍏 Mac (AMD64)
🍏 Mac (ARM/M1)
🟦 Windows (AMD64)

Headlamp is an easy-to-use and extensible Kubernetes web UI.