Skip to content

Headlamp Release Notes

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

CaskVirtualization & Containersย 7.7K
Install command
brew install --cask headlamp
30-day installs
1,207
#238 in App
1-year installs
17.6K
Last 365 days
Latest version
0.46.0
Download size
146MB
dmg
Release cadence
Monthly
2 releases in 30 days
  1. 0.46.0

    Latest

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 12 or later

    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

  2. 0.45.0

    OpenNavo editorial Added to Homebrew

    Lower desktop memory use, new resource views and security fixes.

    Changes
    Reduce desktop startup memory and background polling.Add PVC creation forms, PodGroup and Workload scheduling views.Add TCPRoute and UDPRoute views and pod eviction actions.Fix denied plugin command requests executing on first invocation.Fix relative kubeconfig certificate paths and update dependencies.

    Selected changes from the official Headlamp 0.45.0 release announcement:

    • Reduce desktop startup memory and background polling.
    • Add PVC creation forms, PodGroup and Workload scheduling views.
    • Add TCPRoute and UDPRoute views and pod eviction actions.
    • Fix denied plugin command requests executing on first invocation.
    • Fix relative kubeconfig certificate paths and update dependencies.

    These are selected highlights; the upstream announcement also covers additional fixes, development changes and bundled plugin updates. Some features apply specifically to in-cluster deployments rather than desktop installation.

    Official release notes

  3. 0.44.0

    OpenNavo editorial Added to Homebrew

    Large-cluster performance improvements and expanded creation forms.

    Changes
    Fetch pod lists in batches of 1,000 and improve large Resource Maps.Avoid connecting to every configured cluster at desktop startup.Add DaemonSet, CronJob, Job and ReplicaSet creation forms.Support ConfigMap binaryData and ServiceAccount permission visibility.Restore macOS zoom and improve cluster connection error reporting.

    Selected changes from the official Headlamp 0.44.0 release announcement:

    • Fetch pod lists in batches of 1,000 and improve large Resource Maps.
    • Avoid connecting to every configured cluster at desktop startup.
    • Add DaemonSet, CronJob, Job and ReplicaSet creation forms.
    • Support ConfigMap binaryData and ServiceAccount permission visibility.
    • Restore macOS zoom and improve cluster connection error reporting.

    These are selected highlights; the upstream announcement also covers additional fixes, development changes and bundled plugin updates. Some features apply specifically to in-cluster deployments rather than desktop installation.

    Official release notes

  4. 0.43.0

    Expand

    OpenNavo editorial Added to Homebrew

    Authentication, discovery and resource editing improvements.

    Changes
    Add opt-in service account token authentication for in-cluster use.Add alpha ClusterProfile discovery through the Cluster Inventory API.Add configurable Helm probe schemes and timing settings.Use JSON Patch in the editor to avoid resource update conflicts.Fix OIDC issuer override handling and proxy path-prefix support.

    Selected changes from the official Headlamp 0.43.0 release announcement:

    • Add opt-in service account token authentication for in-cluster use.
    • Add alpha ClusterProfile discovery through the Cluster Inventory API.
    • Add configurable Helm probe schemes and timing settings.
    • Use JSON Patch in the editor to avoid resource update conflicts.
    • Fix OIDC issuer override handling and proxy path-prefix support.

    These are selected highlights; the upstream announcement also covers additional fixes, development changes and bundled plugin updates. Some features apply specifically to in-cluster deployments rather than desktop installation.

    Official release notes

  5. 0.42.0

    Expand

    GitHub Release Added to Homebrew

    Hitch hikers guide to Headlamp 0.42.0

    Deep-link support was added for pod terminals (?view=exec) and log views (?view=logs), letting users bookmark or share direct links to specific UI states. Resources can now be searched by label in all list views, the Log Viewer gains a severity filter dropdown, and a delete button has been added directly to the plugins list. Node Details received two new sections for pod capacity usage and resource allocation, and the Resource Map now renders status badges on plugin-provided nodes and includes previously missing configuration resources. GRPCRoute details reach full parity with HTTPRoute, and a guided form-based resource creation UI (starting with Pods) is now available alongside the YAML editor.

    On the reliability side, a silent cache desync that caused permanently stale cluster data was fixed, along with a lock-order inversion deadlock that could freeze WebSocket connections under load, and a wave of React hooks rule violations across more than a dozen frontend components. Several backend panics were fixed in port-forwarding, kubeconfig parsing, cache key generation, and Helm chart type handling, alongside debounced log aggregation to prevent UI freezes in All Pods mode. Security hardening includes path traversal prevention in the service proxy and dependency bumps.

    โœจ Enhancements (part 1)

    Enhancements
    Added deep-link support for pod exec via ?view=exec query parameter, letting users bookmark or share direct links to open a terminal into a specific pod. Thanks to @justinas-wix. #4941
    Added a hidden 'labels' column to all resource list views so users can search resources by label (e.g. app=test) using the existing search bar. Thanks to @sniok. Also thanks to @illume for reporting the issue. #5035
    Resource map graph nodes now support optional status metadata, allowing plugin-provided nodes to display warning and error badges like built-in resources. Thanks to @mahmoudmagdy1-1. #5349
    Added a pod capacity usage tile to the node details view so users can see how many pods are scheduled versus the node's allocatable pod limit. Thanks to @Vikaspal8923. Also thanks to @jimmyjones2 for reporting the issue. #5039
    Extended a8r.io annotation support from Services to all Kubernetes resources, letting users see human-readable service discovery metadata on any annotated resource. Thanks to @mastermaxx03. #5007
    Added a severity filter dropdown to the Log Viewer, letting users quickly filter logs by level (ERROR, WARN, INFO, DEBUG) to cut through noisy streams. Thanks to @Utkarshpandey0001. #5338
    Added a delete button directly to the plugins list page, so users can remove plugins without navigating to the detail page first. Thanks to @rickbrouwer. #5314
    Added ?view=logs deep-link support on Deployment, ReplicaSet, DaemonSet, and StatefulSet detail pages, letting users open the logs view directly from a URL. Thanks to @bhat-ganesh. #5312
    Added missing configuration resources to the Resource Map graph so they are now fully visible in the Configuration group. Thanks to @vishnukothakapu. #5223
    Added a hidden 'labels' column to all resource list views so users can search resources by label (e.g. app=test) using the existing search bar.
    Added a delete button directly to the plugins list page, so users can remove plugins without navigating to the detail page first.
    Added a guided form-based UI for creating Kubernetes resources (starting with Pods), accessible from the sidebar and Pod list page alongside the existing YAML editor workflow.

    โœจ Enhancements (part 2)

    Enhancements
    Added ephemeral storage usage chart to the Node Details view, giving users visibility into ephemeral storage consumption alongside other node stats. Thanks to @Vikaspal8923. Also thanks to @jimmyjones2 for reporting the issue. #5169
    Added a 'Review changes' tab to the resource editor dialog so users can diff the original manifest against their edits before applying. Thanks to @Vikaspal8923. #5018
    Added a background janitor to evict expired Kubernetes clientsets, fixing an unbounded memory leak that could cause OOM crashes on busy clusters. Thanks to @Joshna907. #5286
    Wrapped the Reconnect button label in LogViewer with the translation function and added the key to all 12 locale files, enabling full i18n support. Thanks to @NAME-ASHWANIYADAV. #5176
    GRPCRoute details view now shows rules, hostnames, matches, backendRefs, and filters, bringing it to full parity with HTTPRoute details. Thanks to @NAME-ASHWANIYADAV. #5174
    Resource map graph nodes now support optional status metadata, allowing plugin-provided nodes to display warning and error badges like built-in resources.
    Added ephemeral storage usage chart to the Node Details view, giving users visibility into ephemeral storage consumption alongside other node stats.
    Added a download YAML button to the resource table, letting users export any resource manifest directly from the table view.
    Improved global search UX by adding a clear button to the search input and showing a pointer cursor on hover over search results.

    โœจ Enhancements (part 3)

    Enhancements
    Added a toast notification when port-forwarding fails so users are explicitly informed instead of errors being silently logged to the console. Thanks to @itvi-1234. #5145
    Added a download YAML button to the resource table, letting users export any resource manifest directly from the table view. Thanks to @Vikaspal8923. #5126
    Added UI support for the Kubernetes VolumeAttributesClass resource in the Storage section, including list and detail views. Thanks to @Vikaspal8923. #5119
    Added service.extraServicePorts and matching Ingress backend support to the Helm chart, allowing sidecar containers to be exposed without a separate Service resource. Thanks to @Soli0222. #5078
    Added a Resource Allocation section to Node Details showing total CPU/Memory requests, limits, and their percentage of node capacity alongside existing usage metrics. Thanks to @itvi-1234. #5048
    Added a guided form-based UI for creating Kubernetes resources (starting with Pods), accessible from the sidebar and Pod list page alongside the existing YAML editor workflow. Thanks to @vyncent-t. #5044
    Container port names are now displayed alongside protocol and port number in the containers list, providing more complete port information at a glance. Thanks to @itvi-1234. Also thanks to @trashhead for reporting the issue. #4956
    Added a pod capacity usage tile to the node details view so users can see how many pods are scheduled versus the node's allocatable pod limit.
    Added a 'Review changes' tab to the resource editor dialog so users can diff the original manifest against their edits before applying.
    Added UI support for the Kubernetes VolumeAttributesClass resource in the Storage section, including list and detail views.
    Container port names are now displayed alongside protocol and port number in the containers list, providing more complete port information at a glance.

    โœจ Enhancements (part 4)

    Enhancements
    Aligned frontend duration/age formatting with Kubernetes apimachinery logic, ensuring consistent age display matching kubectl behavior. Thanks to @ChayanDass. Also thanks to @joaquimrocha for reporting the issue. #4931
    Improved global search UX by adding a clear button to the search input and showing a pointer cursor on hover over search results. Thanks to @Vikaspal8923. #4965
    Extended a8r.io annotation support from Services to all Kubernetes resources, letting users see human-readable service discovery metadata on any annotated resource.
    Added a Resource Allocation section to Node Details showing total CPU/Memory requests, limits, and their percentage of node capacity alongside existing usage metrics.
    Aligned frontend duration/age formatting with Kubernetes apimachinery logic, ensuring consistent age display matching kubectl behavior.

    ๐Ÿž Bug fixes (part 1)

    Bug fixes
    Fixed pod status icon remaining stuck on warning in list view after a pod becomes healthy, without requiring a page refresh. Thanks to @nidhi-9900. Also thanks to @nullzone for reporting the issue. #5059
    Fixed performance regressions in the resource map by properly memoizing values to avoid redundant graph rebuilds, improving responsiveness on larger clusters. Thanks to @sniok. Also thanks to @itpick for reporting the issue. #4961
    Fixed a silent cache desync bug where a dead watcher locked the registry and prevented cache invalidation, causing the UI to show permanently stale cluster data. Thanks to @KumarADITHYA123. #5163
    Removed the --no-quarantine flag from the macOS Homebrew installation command to reflect the current recommended install process. Thanks to @saivenkateshi. Also thanks to @hyorimlee for reporting the issue. #4943
    Debounced log aggregation in All Pods mode to eliminate UI freezes when streaming large volumes of logs. Thanks to @Utkarshpandey0001. #5320
    Fixed react-hooks/rules-of-hooks violations in secret/Details.tsx by extracting the inline section helper into a proper React component, preventing potential hook-related bugs. Thanks to @iashutoshyadav. Also thanks to @illume for reporting the issue. #5266
    Fixed missing data columns (Status, Replicas, etc.) in CustomResourceDetails for core resources whose apiVersion contains no slash, such as Nodes. Thanks to @Joshna907. #5259
    Fixed react-hooks/rules-of-hooks violations in GraphView.tsx by moving hook calls unconditionally into function bodies, preventing potential rendering bugs. Thanks to @iashutoshyadav. Also thanks to @illume for reporting the issue. #5252
    Fixed react-hooks/rules-of-hooks violations in configmap/Details.tsx by extracting the inline section helper into a proper React component, also resolving a variable shadowing issue in map callbacks. Thanks to @jedbillyb. Also thanks to @illume for reporting the issue. #5203
    Fixed a React hooks violation in VolumeDetails where useTranslation was called after an early return, preventing potential runtime errors. Thanks to @itvi-1234. Also thanks to @illume for reporting the issue. #5201

    ๐Ÿž Bug fixes (part 2)

    Bug fixes
    Replaced fmt.Printf calls with structured logging in ListPlugins, improving log consistency and simplifying plugin-related test reliability. Thanks to @NAME-ASHWANIYADAV. #5072
    Fixed a crash on the Namespace details page when ResourceQuota status is absent immediately after creation, preventing blank or broken quota displays. Thanks to @Vikaspal8923. #4990
    Fixed heading hierarchy in the ReleaseNotes story so h3 elements are always preceded by proper h1/h2 ancestors, ensuring correct document structure. Thanks to @iashutoshyadav. Also thanks to @illume for reporting the issue. #5356
    Added missing aria-controls attribute to EditorDialog action buttons, improving accessibility for assistive technology users. Thanks to @Utkarshpandey0001. #5355
    Fixed a nil-pointer panic in port-forwarding that could crash the backend when a port-forward process exited gracefully and its error channel was closed. Thanks to @Joshna907. #5342
    Resource map breadcrumbs now pass apiGroup alongside kind to icon lookups, so resources like apps/ReplicaSet display their correct icon instead of the generic cube. Thanks to @mahmoudmagdy1-1. #5332
    Fixed the "Use evict for pod deletion" setting not persisting as disabled across reloads by replacing a logical OR with nullish coalescing so an explicit false is correctly saved. Thanks to @Utkarshpandey0001. #5328
    Fixed orphaned goroutines and lingering port listeners in the port-forwarding module, preventing memory leaks and stuck local ports after a port-forward is deleted or times out. Thanks to @Joshna907. #5316
    Fixed a lock-order inversion deadlock in the multiplexer that could freeze WebSocket connections under concurrent load. Thanks to @KumarADITHYA123. #5307

    ๐Ÿž Bug fixes (part 3)

    Bug fixes
    Fixed corrupted Kubernetes cache keys caused by incorrect parsing of internal URLs, preventing cache pollution and key collisions. Thanks to @Joshna907. #5292
    Silent errors in advanced search query parsing and filter evaluation are now logged via console.debug, making failures easier to diagnose. Thanks to @NAME-ASHWANIYADAV. #5284
    Fixed a double-response bug in InstallRelease where execution continued after sending a 500 error, preventing corrupted HTTP responses. Thanks to @NAME-ASHWANIYADAV. #5277
    Fixed a crash (white screen) caused by malformed JWTs during decoding, improving stability for plugins using the getUserInfo utility. Thanks to @Joshna907. #5270
    Fixed npm run star so developers can load Headlamp in dev mode on Windows without repeated reloads or long waits. Thanks to @illume. #5256
    Fixed a React hooks-rules violation in useKubeObject where WebSocket hooks were called conditionally, ensuring reliable WebSocket behaviour regardless of feature flags. Thanks to @aabhinavvvvvvv. Also thanks to @illume for reporting the issue. #5253
    Fixed a React hooks-rules violation in the router by extracting an inline arrow function into a named component, preventing unpredictable hook behaviour during routing. Thanks to @aabhinavvvvvvv. Also thanks to @illume for reporting the issue. #5251
    Fixed a React hooks-rules violation in usePrefersColorScheme by moving useState and useEffect above the early return, ensuring consistent color-scheme detection. Thanks to @aabhinavvvvvvv. Also thanks to @illume for reporting the issue. #5250
    Fixed a React hooks-rules violation in useWatchKubeObjectLists by calling both sub-hooks unconditionally, preventing potential runtime errors from conditional hook calls. Thanks to @aabhinavvvvvvv. Also thanks to @illume for reporting the issue. #5249
    Fixed the AuthChooser AnError Storybook story to always render a non-empty DialogTitle, eliminating an empty h1 accessibility issue. Thanks to @iashutoshyadav. Also thanks to @illume for reporting the issue. #5239

    ๐Ÿž Bug fixes (part 4)

    Bug fixes
    Fixed a fatal UI crash caused by malformed or empty sidebar data in browser localStorage during Redux state initialization. Thanks to @Joshna907. #5235
    Fixed React hooks rule violations in the PortForward component that could cause unpredictable rendering behavior. Thanks to @iashutoshyadav. Also thanks to @illume for reporting the issue. #5231
    Pinned the gcb-docker-gcloud Cloud Build image by digest to prevent CI failures caused by garbage-collected tags. Thanks to @skoeva. #5229
    Fixed a server crash that occurred when installing or upgrading unsupported Helm chart types such as library charts. Thanks to @KumarADITHYA123. #5217
    Fixed a backend panic in cache invalidation that crashed the server when a GenerateKey error was silently ignored on short API paths. Thanks to @KumarADITHYA123. #5215
    Fixed React hooks rule violations in CustomResourceListTable where useMemo calls after an early return caused unpredictable rendering. Thanks to @aabhinavvvvvvv. Also thanks to @illume for reporting the issue. #5213
    Renamed withEnv decorator to PascalCase in AppContainer stories, fixing rules-of-hooks ESLint violations. Thanks to @jedbillyb. Also thanks to @illume for reporting the issue. #5210
    Renamed story component functions to PascalCase in PluginSettingsDetails stories, resolving rules-of-hooks ESLint errors. Thanks to @jedbillyb. Also thanks to @illume for reporting the issue. #5209
    Moved useCallback before the early return in DialogTitle and added missing focusTitle dependency, fixing rules-of-hooks violations. Thanks to @jedbillyb. Also thanks to @illume for reporting the issue. #5208
    Moved all hook calls before the early return in RollbackButton, fixing rules-of-hooks violations and improving TypeScript type narrowing. Thanks to @jedbillyb. Also thanks to @illume for reporting the issue. #5206

    ๐Ÿž Bug fixes (part 5)

    Bug fixes
    Fixed and re-enabled a previously skipped multiplexer test, improving test suite reliability. Thanks to @sniok. #5179
    Removed an unsafe as any TypeScript cast in VersionButton by providing an explicit generic type to useQuery, improving type safety. Thanks to @itvi-1234. #5164
    Fixed a backend panic crash in GetAPIGroup caused by index out of range errors when Kubernetes discovery paths were shortened or truncated. Thanks to @KumarADITHYA123. #5161
    Fixed a bug where a stale global namespace filter could hide results in namespace-scoped views when no namespace filter should apply. Thanks to @Vikaspal8923. Also thanks to @jimmyjones2 for reporting the issue. #5157
    Fixed Helm repository and chart handler error behavior, including proper 404 responses on missing repos and safer lock error handling. Thanks to @Athang69. #5149
    Fixed Content-Type: application/json header being silently dropped in 7 Helm release API handlers, ensuring clients receive correct response metadata. Thanks to @NAME-ASHWANIYADAV. #5147
    Fixed a server panic caused by bare type assertions in kubeconfig parsing when processing malformed kubeconfig files. Thanks to @KumarADITHYA123. #5138
    Added missing Pi and P memory unit support to normalizeUnit and corrected off-by-one multipliers for Ei and E, ensuring accurate Kubernetes quantity parsing. Thanks to @KumarADITHYA123. #5135
    Fixed a bug in k8cache where Kubernetes resources older than 60 seconds silently skipped cache invalidation on Update or Delete, preventing stale data from being cleared. Thanks to @KumarADITHYA123. #5130
    Removed debug console.log statements and fixed a typo in the frontend, keeping the production console clean. Thanks to @NAME-ASHWANIYADAV. #5129

    ๐Ÿž Bug fixes (part 6)

    Bug fixes
    Removed an unnecessary debug console.log from the clusterRequests remove() function to keep the production console clean. Thanks to @NAME-ASHWANIYADAV. #5127
    Fixed backend linting on Windows with LF line endings and compatible Makefile targets, replaced deprecated fake clientset, and bumped helm/v3 to 3.20.2. Thanks to @skoeva. #5121
    Long cluster names in the Home page table now expand dynamically and show the full name on hover, improving readability. Thanks to @vyncent-t. Also thanks to @hpschry and @jimmyjones2 for reporting the issue. #5109
    Fixed resourceFieldRef env vars failing to resolve for admission-injected sidecar containers like istio-proxy, eliminating 'Container not found' errors. Thanks to @itvi-1234. Also thanks to @vmozghovyi for reporting the issue. #5107
    Fixed helm route auth token handling to work unconditionally and added regression tests for helm auth and RouteSwitcher key uniqueness. Thanks to @Athang69. Also thanks to @v0lkan for reporting the issue. #5105
    Replaced console.log with console.error in catch blocks so exceptions are correctly flagged in browser DevTools and log monitoring tools. Thanks to @NAME-ASHWANIYADAV. #5104
    Users now see an error notification when cluster deletion fails instead of silently receiving no feedback. Thanks to @NAME-ASHWANIYADAV. #5102
    Fixed the ResourceTable Name Search Storybook example so the search input is correctly prefilled and table filtering works as expected. Thanks to @Vikaspal8923. Also thanks to @sniok for reporting the issue. #5100
    Updated npm dependencies via audit to address known vulnerabilities, with Electron upgraded to the latest version. Thanks to @sniok. #5097
    Fixed a crash on CronJob list and details pages when spec.suspend is absent from the API response, preventing a TypeError on undefined. Thanks to @Athang69. Also thanks to @RobertSkawinski for reporting the issue. #5085

    ๐Ÿž Bug fixes (part 7)

    Bug fixes
    Helm chart now automatically mounts an emptyDir volume at /tmp when readOnlyRootFilesystem is enabled, fixing deployment failures in restricted security contexts. Thanks to @YotamKorah. Also thanks to @wkbrd for reporting the issue. #5079
    Removed a leftover console.log debug statement from HTTPRouteDetails, eliminating unnecessary noise in the browser console. Thanks to @NAME-ASHWANIYADAV. #5074
    Fixed double-write HTTP responses and missing headers in Helm backend handlers, ensuring correct and well-formed API responses. Thanks to @NAME-ASHWANIYADAV. #5056
    Fixed typos and improved error logging in OauthPopup by correcting 'occured' to 'occurred' and using console.error for proper error severity reporting. Thanks to @NAME-ASHWANIYADAV. #5054
    Fixed a copy-paste bug where GRPCRoute used the wrong section ID (httproute-parentrefs) and removed leftover debug console.log statements from production code. Thanks to @NAME-ASHWANIYADAV. #5052
    Cluster action error notifications now surface detailed Kubernetes API error messages instead of generic failure text, making it easier to diagnose rejected operations like ValidatingAdmissionPolicy failures. Thanks to @itvi-1234. Also thanks to @jimmyjones2 for reporting the issue. #5047
    Fixed broken app startup after npm install due to an esbuild error by regenerating package-lock.json, updating frontend snapshots, and reverting the merge commit check. Thanks to @illume. #5029
    Fixed a Map view bug where resources with the same name in different namespaces were incorrectly linked by adding namespace checks to resource relation matching. Thanks to @itvi-1234. Also thanks to @rassie for reporting the issue. #5006
    Fixed AppImage crash on Linux caused by chrome-sandbox permission issues by disabling the setuid sandbox in AppImage environments. Thanks to @kunaldevsahu. Also thanks to @eftewuer for reporting the issue. #4996
    Fixed truncation of long Kubernetes condition names (e.g. PodReadyToStartContainers) in resource detail Conditions tables so full names are always visible. Thanks to @itvi-1234. #4967
    Fixed pod metrics matching to use both name and namespace, preventing incorrect CPU/memory stats for pods sharing the same name across different namespaces. Thanks to @Utkarshpandey0001. #4933
    Fixed GlobalSearch bar visibility on dark or colored navbars by adding explicit backgrounds, ensuring the search field is visible at all zoom levels and themes. Thanks to @skoeva. #4930

    ๐Ÿ”’ Security

    Security improvements
    Hardened service proxy URI validation to block path traversal and protocol-relative URLs that could redirect requests to arbitrary hosts. Thanks to @skoeva. #5299
    Bumped multiple app, plugin, and backend dependencies including storybook, i18next-fs-backend, xmldom, and headlamp-plugin to keep packages up to date and fix build issues. Thanks to @skoeva. #5122
    Bumped backend and headlamp-plugin dependencies including OpenTelemetry, go-jose, and Vite to keep packages up to date and secure. Thanks to @skoeva. #5108
    Validate host header to protect desktop and headless users. Thanks to @illume. Also thanks to Koda Reef for reporting the issue. #5419
    Updated SECURITY.md to reference the kubernetes-sigs security policy, making it easier to find for contributors browsing the repo. Thanks to @illume. Also thanks to @rassie for reporting the issue. #5081
    Bumped multiple dependencies including tar, flatted, typedoc, body-parser, undici, and others to address security and compatibility updates. Thanks to @skoeva. #4948
    Bumped tar dependency from 7.5.10 to 7.5.11 in the sidebar plugin example to include a symlink escape fix. . #4880

    โ™ฟ Accessibility

    Accessibility improvements
    Replaced the accessible-name violation caused by role=button on a label element in DropZoneBox with a ref-based file input trigger. Thanks to @skoeva. #5272
    Unified sorting icons in SimpleTable to match ResourceTable's MUI arrow style and added tooltips to sorting buttons for better accessibility. Thanks to @Utkarshpandey0001. #4952
    Fixed heading hierarchy in the ReleaseNotesModal story so the h3 fixture is properly nested under h1/h2 ancestors, and updated the storyshot snapshot to match. Thanks to @iashutoshyadav. Also thanks to @illume for reporting the issue. #5315

    ๐Ÿ“– Documentation

    Documentation improvements
    Deduplicated nodes and edges in the resource map graph after merging sources, eliminating duplicate elements that could cause rendering issues. Thanks to @mahmoudmagdy1-1. #5400
    Added NKP (Nutanix Kubernetes Platform) to the supported platforms documentation, confirming it works with Headlamp out of the box. Thanks to @jlnhnng. #5173
    Added Linode Kubernetes Engine (LKE) to the list of tested and supported platforms in the documentation. Thanks to @ruckus-voxi. #5116
    Added a tutorial showing how to build a WhoAmI plugin that displays user identity in the cluster sidebar using the SelfSubjectReview API. Thanks to @yolossn. #5080
    Fixed multiple documentation issues including a grammatical error, stale Code of Conduct link, duplicate sections, outdated dependency versions, and broken internal links. Thanks to @Athang69. #5060
    Added documentation for MCP (Model Context Protocol) support to the Headlamp learn section, helping users discover and configure the feature. Thanks to @vyncent-t. #4998
    Added HolmesGPT documentation to the Learn section, making it easier to find and use HolmesGPT guidance within the docs. Thanks to @vyncent-t. #4997

    ๐Ÿ’ป Development (part 1)

    Development improvements
    Added end-to-end tests verifying the Prometheus plugin is correctly bundled and its settings page is accessible in the UI. Thanks to @illume. #5362
    Storybook mocks now return HTTP 404 for deprecated v1beta1 CRD endpoints, better reflecting real cluster behavior in component stories. Thanks to @mystic-06. Also thanks to @skoeva for reporting the issue. #5040
    Host header validation added on loopback listeners to reduce the risk of DNS rebinding attacks against the local backend server. Thanks to @illume. #5419
    Bumped Go to 1.25.9 to address stdlib CVEs, improving the security of the backend. Thanks to @yolossn. #5410
    Kubernetes volume status phases such as "Bound" and "Pending" are now translated, so they respect the user's selected locale instead of always appearing in English. Thanks to @Joshna907. #5331
    Core API discovery failures (e.g. due to timeouts or RBAC issues) are now logged instead of silently swallowed, making it easier to diagnose missing resources in the UI. Thanks to @Joshna907. #5329
    Switched plugin cache error checks to use errors.Is() so wrapped cache.ErrNotFound errors are correctly detected and plugin listing behaves reliably. Thanks to @NAME-ASHWANIYADAV. #5326
    Reverted Storybook stories for AddCluster component that were causing CI failures. Thanks to @skoeva. #5301
    Silent errors in terminal shell detection functions are now logged via console.debug, making node shell connection failures easier to debug. Thanks to @NAME-ASHWANIYADAV. #5282
    Replaced direct Helm sentinel error comparisons with errors.Is, ensuring wrapped errors are correctly detected in release-not-found checks. Thanks to @NAME-ASHWANIYADAV. #5280
    Reverted a namespace filter reset change that caused crashes when navigating to namespace views with an active namespace filter selected. Thanks to @sniok. #5271
    Added an i18n-check step to CI to automatically catch translation file regressions as dependencies and code are updated. Thanks to @illume. #5257
    Added Storybook stories for the KubeConfigLoader component, enabling visual testing of all kubeconfig upload and cluster import UI states.

    ๐Ÿ’ป Development (part 2)

    Development improvements
    Refactored Event hooks into standalone exported functions, fixing React hooks-rules violations and making useEventListForClusters and useEventWarningList available to consumers. Thanks to @Utkarshpandey0001. Also thanks to @illume for reporting the issue. #5255
    Replaced log.Printf with the structured logger in the telemetry package, aligning warning output with the rest of the backend. Thanks to @NAME-ASHWANIYADAV. #5221
    Added Copilot PR review instructions to automate common review feedback, helping enforce project standards more consistently. Thanks to @joaquimrocha. #4937
    Added console.debug logging to previously silent catch blocks across frontend components, making errors visible during debugging. Thanks to @NAME-ASHWANIYADAV. #5220
    Replaced hardcoded context.TODO() in the service proxy with proper request-scoped context, enabling correct cancellation and deadline propagation. Thanks to @NAME-ASHWANIYADAV. #5219
    Replaced an incorrectly imported MUI icon with the Iconify equivalent in the Table component, restoring consistent icon rendering. Thanks to @sniok. #5178
    Replaced console.log with console.debug for IndexedDB operational messages, keeping them available in development while hiding them in production. Thanks to @NAME-ASHWANIYADAV. #5177
    Removed 54 lines of unreachable dead code from UpdatePopup and hardened window.open usage, simplifying the component and improving safety. Thanks to @NAME-ASHWANIYADAV. #5175
    Expanded test coverage for the k8cache package, covering previously untested branches to improve backend reliability. Thanks to @Athang69. #5172
    Upgraded Node.js to v22.x LTS across all CI workflows and package.json engines fields to stay ahead of Node 20 end-of-life. Thanks to @sniok. #5170
    Removed a legacy Webpack-specific workaround from ErrorPage, cleaning up the component now that Headlamp fully uses Vite for SVG imports. Thanks to @itvi-1234. #5143
    Enabled eslint-plugin-react-hooks lint rules in the frontend to surface hard-to-debug React hook mistakes earlier in development. Thanks to @sniok. #5155
    Frontend lint warnings are now enforced as CI-blocking errors, with pre-existing violations suppressed, improving long-term code quality. Thanks to @illume. #5196
    Added Storybook stories for the AddCluster component, making it easier to visually develop and test its key UI states.

    ๐Ÿ’ป Development (part 3)

    Development improvements
    Added a README for the Headlamp Releaser CLI tool documenting prerequisites, usage, and how it automates version bumping, tagging, and publishing. Thanks to @illume. #4942
    Increased pkg/config test coverage from 74.2% to 83.9% by adding unit tests for session TTL validation and default-application logic. Thanks to @Athang69. #5139
    Removed the Create button from pod lists inside parent resource detail views (e.g. Jobs, Deployments) where adding pods directly is not valid. Thanks to @kannon92. #5136
    CRD list fetch errors in the sidebar now use console.error instead of console.log, ensuring correct severity in browser developer tools. Thanks to @NAME-ASHWANIYADAV. #5128
    Added unit tests for the Helm handler, bringing test coverage from 0% to 90.8% and improving backend reliability. Thanks to @Athang69. #5124
    Replaced context.TODO() with explicit context.Background() in the drainNode goroutine, fixing improper context propagation in the backend. Thanks to @itvi-1234. #5095
    Removed leftover development console.log statements from the Backstage integration to keep the browser console clean in production. Thanks to @itvi-1234. #5094
    Replaced loose as any casts with strictly typed Partial<Response> in auth tests, reducing the risk of silent false-positive test results. Thanks to @itvi-1234. #5075
    Removed an outdated TODO comment in NameValueTable.tsx that no longer applies after the React 18 migration was completed. Thanks to @itvi-1234. #5064
    Escaped URLs in library typedoc comments to prevent the parser from misinterpreting them. Thanks to @ashu8912. #5027
    Fixed activity panel text alignment for the cluster indicator and corrected text colors for themes with custom primary colors such as 'Lights Out'. Thanks to @sniok. #5020
    Added 13 Storybook stories for ResourceTableMultiActions, covering all meaningful selection states to aid frontend development and testing. Thanks to @mystic-06. Also thanks to @illume for reporting the issue. #4971
    Added Storybook stories for the AddCluster component, making it easier to visually develop and test its key UI states. Thanks to @Dharmiksarvaiya24. Also thanks to @illume for reporting the issue. #5171
    Added Storybook stories for the KubeConfigLoader component, enabling visual testing of all kubeconfig upload and cluster import UI states. Thanks to @vishnukothakapu. Also thanks to @illume for reporting the issue. #5166

    ๐Ÿงฉ Official Plugin releases

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.42.0 Desktop Apps:

    โš ๏ธ Important: Information on warnings from Mac and Windows when running Headlamp unsigned apps.

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  6. 0.40.0

    Expand

    GitHub Release Added to Homebrew

    โœจ Enhancements:

    • Add icon and color configuration to clusters. Thanks to @alexmathieu22
    • Allow saving selected namespaces per cluster. Thanks to @mudit06mah
    • Add configurable keyboard shortcuts Thanks to @alokdangre
    • Add HTTPRoute support for Gateway API via new values and template. Thanks to @hxrshxz
    • Display a8r.io service metadata in service views. Thanks to @mastermaxx03
    • Make in-cluster context name configurable. Thanks to @iamhalje
    • Minimize activities blocking the main content when needed Thanks to @joaquimrocha
    • Add extraContainers field to Helm chart. Thanks to @lszczepaniak-XM
    • Add ability to specify topologySpreadConstraints in Helm chart. Thanks to @irasnyd
    • Add volume mounts on plugin helper sidecar. Thanks to @martinbfrey
    • Add meUserInfoURL to secrets template. Thanks to @mudit06mah
    • Improve French translation. Thanks to @arthurphilippe
    • Allow configuring log level via command line arg and environment variable. Thanks to @aadhil2k4
    • Add vertical snap positions for activities. Thanks to @kahirokunn
    • Add deeplink compatibility for viewing Pod logs. Thanks to @mudit06mah
    • Unauthenticated users can now follow deeplinks. Thanks to @mudit06mah
    • Add debugging ephemeral container support. Thanks to @alexmathieu22

    Appearance Configuration per cluster

    Image: Icon for cluster

    Image: Appearance Configuration per cluster

    Add service info from a8r.io metadata

    Image: Add service info from a8r.io metadata

    ๐Ÿงฉ Shipped Plugins

    • Update shipped plugin Prometheus
      • Settings: Added a test connection button
      • Add i18n support
      • Upgrade kinvolk/headlamp-plugin to 0.13.1

    ๐Ÿž Bug fixes

    • Fix showing corrupt file on Mac. Thanks to @mastermaxx03
    • Fix checking for existing project names. Thanks to @pallava-joshi
    • Fix focus trapping when resource drawer is open. Thanks to @pallava-joshi
    • Fix MaxListenersExceededWarning. Thanks to @greedy-wudpeckr
    • Fix getMainAPIGroup undefined error. Thanks to @mudit06mah
    • Fix headlamp-plugin package failing on dist subdirectories. Thanks to @skoeva
    • Fix Deployment.yaml template. Thanks to @mudit06mah
    • Fix NameValueTable spacing issue. Thanks to @alokdangre
    • Fix ARIA labels for input fields. Thanks to @vyncent-t
    • Fix warning label color contrast. Thanks to @vyncent-t
    • Fix many a11y issues. Thanks to @illume
    • Implement ad-hoc signing for macOS arm64 to fix damaged app error. Thanks to @mastermaxx03
    • Quote OIDC_USE_PKCE value to ensure it's a string. Thanks to @dihmandrake
    • Fix package pattern in Helm chart release workflow. Thanks to @onedr0p
    • Fix CI failures. Thanks to @skoeva
    • Hide empty top bar overflow menu on small screens. Thanks to @d1vyanshu-kumar

    ๐Ÿ’ป Development

    • Add AGENTS.md for AI-assisted development. Thanks to @illume
    • Add AGENTS.md to created plugins and bundle examples. Thanks to @illume
    • Add app/ development documentation and linting/formatting scripts. Thanks to @illume
    • Move yolossn from headlamp-reviewers to headlamp-maintainers. Thanks to @yolossn
    • Bump headlamp-plugin to 0.13.0 in example plugins. Thanks to @skoeva
    • Bump Storybook version in frontend plugins. Thanks to @skoeva
    • Bump tar to 7.5.7. Thanks to @skoeva
    • Update dependencies. Thanks to @skoeva
    • Add fast-check property tests for unit parsers. Thanks to @illume
    • Pin GitHub Actions by hash in draft-release workflow. Thanks to @skoeva
    • Skip chart release if it already exists. Thanks to @sniok
    • Remove unused frontend code. Thanks to @skoeva

    ๐Ÿ“– Documentation

    • Add ingress basic auth guide for in-cluster deployments. Thanks to @aaryan359
    • Add Quick Start for Contributors section to README. Thanks to @TRIVENI206
    • Add Talos to supported platforms. Thanks to @alexmathieu22
    • Fix Dex OIDC block indentation in values.yaml snippet. Thanks to @archups

    ๐Ÿ›ก๏ธ Security

    • Add @illume and @yolossn to SECURITY_CONTACTS. Thanks to @illume

    Full Changelog: https://github.com/kubernetes-sigs/headlamp/compare/v0.39.0...v0.40.0


    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.40.0 Desktop Apps:

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  7. 0.38.0

    Expand

    GitHub Release Added to Homebrew

    โœจ Enhancements:

    • Add custom local port input dialog for port forwarding. Thanks @jaehanbyun
    • Add concept of "shipped", "user-installed", and "dev" plugin types
    • Add ability to specify priorityClassName in the Headlamp Helm chart. This allows setting the relative priority of Headlamp compared to other Pods when Headlamp is deployed in a cluster. Thanks @mcg1024

    Custom Local Port Forwarding Dialog

    A custom local port selection dialog for port forwarding was added. Allowing people to specify their preferred local ports (e.g., 8080) instead of only using auto-assigned ports.

    https://github.com/user-attachments/assets/27cab13c-773d-421a-bf9e-1678732aa54c

    Enhanced Plugin System to Handle Different Types of Plugins Better

    The plugin loading system has been enhanced. It now differentiates plugins by type (shipped with app/user-installed/development) and loads them according to a priority-based system. Development plugins have the highest priority, followed by user-installed, then shipped plugins. When multiple versions of the same plugin exist, only the highest priority enabled version is loaded.

    The UI has been enhanced to show the different types of plugins. To also make finding where they are easier.

    ๐Ÿž Bug fixes

    • Fix useAccessToken arg not set when using external secrets in Helm chart. Thanks @rickliujh
    • Fix missing PKCE arg in Helm charts. Thanks @rayshoo
    • Fix Add Local Cluster Provider link on Add Cluster view
    • Fix so username is displayed in Top Bar for when Headlamp is behind an Oauth2Proxy
    • Remove extra 1px border on top of the Side Bar
    • Improve headlamp port clashes for the Headlamp app when it is starting and ports are already used
    • Fix reloading of app after plugin install when using Windows app

    Port Clashes Fixed in Headlamp Desktop App

    Before Headlamp tried to listen on port 4466 with the desktop app. If that port was already used then Headlamp would just try to use that existing port. This was problematic of course if there are other apps using that port, or other users on the same machine using that port. Now Headlamp will use another port if that port is already used.

    ๐Ÿ’ป Development

    • Remove our homebrew and winget package creation automation, because they are handled by them now
    • Add action to push chocolatey package automatically
    • Update dependencies for security updates
    • Fix storybook theme for plugins, and use correct new logo in storybook for plugins

    For Plugin Developers: Find Plugin Folder in the UI

    To make it easier for plugin developers to find where on the local file system plugins are there is an open plugin folder button. In Plugin Settings select the plugin being developed, and then click the open folder icon to open the plugin path with the Desktop file Finder.

    ๐Ÿ“– Documentation

    Full Changelog: https://github.com/kubernetes-sigs/headlamp/compare/v0.37.0...v0.38.0

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.38.0

    Desktop Apps:

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  8. 0.36.0

    Expand

    GitHub Release Added to Homebrew

    โœจ Enhancements:

    • Add support for EndpointSlice resources
    • Add memory for table sorting column and direction across navigation. Thanks to @krrish-sehgal
    • Enhance global search to support searching by labels and improve multi-term queries
    • Add a button to copy a resource's name to the clipboard. Thanks to @farodin91
    • Standardize resource naming behavior across all resource types. Thanks to @farodin91
    • Add support for more rule types in HTTPRoute resources. Thanks to @farodin91
    • Fix and improve the log viewer inputs for responsiveness and usability
    • Add a default security context and allow the plugins manager to use the global security context in Helm charts. Thanks to @jda258
    • Add optional backend TLS termination support. Thanks to @shahvrushali22 and @vijayant7
    • Add support for an optional PodDisruptionBudget in the Helm chart. Thanks to @jcpunk
    • Add the ability to specify custom podLabels in the Helm chart. Thanks to @vnea
    • Add snackbar notifications for plugin deletion actions
    • Add support for opening external URLs from the sidebar in a new tab. Thanks to @Exar04
    • Add namespaceOverride support to the Helm chart. Thanks to @rstribrn
    • Allow plugins to override default tabs in the project details view
    • Add an isEnabled method to allow plugins to conditionally render project detail tabs
    • Add support for HEADLAMP_APP_ and REACT_APP_ environment variables in plugins
    • Add support for running Headlamp embedded within Backstage
    • Add the ability for plugins to register a custom delete button for projects
    • Add a loader and error page for the initial backend connection

    Copy resource name to clipboard

    Image: Screenshot shows the clipboard copy button

    Persistent Table sorting

    Tables will now remember your sorting choices

    Image: A table showing the Namespace field is sorting

    Search improvements

    You can now search by labels and combine multiple terms by separating them with spaces

    Image: Search results showing part-of=flux

    Added support of EndpointSlices

    EndpointsSlices are now available in Network sidebar

    Image: Screenshot shows the EndpointSlices menu option with a table full of data

    ๐Ÿž Bug fixes

    • Fix the text contrast of notification menu items on dark themes
    • Fix the base URL feature to ensure the application loads correctly when a base URL is configured. Thanks to @DanielLeone
    • Fix an issue where deleting one dynamic cluster removed all clusters from the same kubeconfig
    • Prevent stale entries from appearing after renaming a dynamic cluster
    • Fix truncated Chinese text in the resource map's graph view buttons. Thanks to @wingerx
    • Update the "Type" column header to "Kind" in resource tables for consistency. Thanks to @LinPr
    • Fix bundling for icons to ensure they are visible in offline mode
    • Add backward compatibility to createRouteURL to accept URL paths for route names
    • Restore the GetTokenFromCookie call within the ParseClusterAndToken function
    • Handle cases where routeName is undefined in getRoute to prevent crashes
    • Correct the positioning of CPU/Memory tooltips in the Nodes table. Thanks to @jaehanbyun
    • Close the actions menu when the "Edit" button is clicked. Thanks to @jaehanbyun)
    • Add a fallback for idpIssuerURL to prevent issues with token expiration. Thanks to @lszczepaniak-XM
    • Fix security context rendering in Helm charts for CI jobs
    • Fix a glob pattern in setup-plugins.js to support Windows paths
    • Fix createRouteURL to correctly look up routes registered from plugins
    • Fix project creation when multiple clusters are involved
    • Prevent dialog checkbox clicks from triggering table row selection. Thanks to @jaehanbyun
    • Disable the backend loader to prevent an error page on application load

    ๐Ÿ’ป Development

    • Refactor the GetExpiryUnixTimeUTC function into the auth package
    • Refactor the configuration parsing function for clarity and reduced complexity
    • Extract DropZoneBox into its own reusable component
    • Update application dependencies, removing electron/notarize and adding glob
    • Replace usages of the deprecated makeKubeObject() function with the KubeObject class
    • Fix circular dependencies in the lib/k8s folder by using import type
    • Extract functions from fetch.ts to new files to avoid circular imports
    • Resolve circular dependencies in the k8s API proxy imports
    • Refactor the router implementation to untangle module imports
    • Add Storybook stories for the DateLabel component
    • Refactor the CacheRefreshedToken function into the auth package
    • Use import type in more files to separate type and value imports
    • Bump the Vite dependency to version 6.3.6 in the frontend and plugins
    • Refactor the IsTokenAboutToExpire function into the auth package
    • Add logging to the plugin npm start command to show where files are copied
    • Fix Storybook support for plugins
    • Export missing functions and types from the headlamp-plugin package
    • Fix the return type for HeaderActionFuncType to correctly include ReactNode
    • Refactor the GetNewToken function into the auth package
    • Fix the Docker extension release process to consistently use the latest tag
    • Disable the nightly build workflow on forked repositories
    • Update the failing EndpointSlice snapshot test
    • Improve the plugin create command's speed and security by using npm ci
    • Update GitHub issue templates to use correct repository labels. Thanks to @jaehanbyun

    ๐Ÿ“– Documentation

    • Enhance the AKS cluster OAuth documentation with clearer steps and Helm-based deployment instructions
    • Update the project name in the NOTICE file
    • Add a note about the removal of libgconf-2-4 on newer Ubuntu releases
    • Add VKS (VMware Kubernetes Service) to the list of supported platforms. Thanks to @papivot
    • Fix a broken link to the architecture page from the plugins documentation

    ๐Ÿงฉ Shipped Plugins

    • Update shipped plugin prometheus 0.8.0
      • Update dependencies
    • Update shipped plugin plugin-catalog 0.4.1 (desktop only)
      • Update dependencies
      • Fix contrast on loading install button
      • Fix origin link
    • Update shipped plugin app-catalog 0.6.3 (desktop only)
      • Update dependencies
      • Add package script

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.36.0 Desktop Apps:

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  9. 0.32.0

    Expand

    GitHub Release

    โœจ Enhancements:

    • Add new advanced search feature (allows searching Kubernetes resources using queries in Js, more languages coming soon)
    • Display Custom Resources in the map (thanks to @faebr, @alexandernorth, @VictorMarcolino)
    • Allow to delete clusters that are coming from local kubeconfigs

    New Advanced Search (access it under the cluster tab): Image: Screenshot showing new advanced search

    ๐Ÿž Bug fixes

    • Reset logs' state on item change
    • Fix OIDC token refresh logic
    • Remove unneeded URL change when closing a details pane

    ๐Ÿ’ป Development

    • Added releaser tool to help manage and automate the release process
    • Add support for plugins to register a custom map node glance (thanks to @userAdityaa)
    • Update sample ingress URL to use kubernetes-sigs/headlamp (thanks @dorser)
    • Update sample ingress to use ingressClassName instead of deprecated annotation (thanks @dorser)
    • Add more tsdocs to misc functions
    • Add Github pull request template (thanks to @SinghaAnirban005 )
    • Refactor plugin-management into a package (pluginctl) (thanks to @Faakhir30 )
    • Add ReferenceGrant resource and tests (thanks to @userAdityaa )
    • Disable tracing by default in backend's telemetry instrumentation (thanks to @DhairyaMajmudar )
    • Add the possibility for the map's nodes to have weights (thanks to @adwait-godbole )
    • Replace ConfirmDialog's switch with a check box and improve the buttons' labels
    • Add more options to the Dockerfile to make it more flexible when needed to use e.g. push
    • Add cloudbuild.yml for future integration with Kubernetes image publishing infrastructure
    • Misc dependency updates

    ๐ŸŒ Internationalization

    • Update Hindi (thanks to @SinghaAnirban005)
    • Make NamespaceAutocompletion's placeholder translatable (thanks to @SinghaAnirban005)

    ๐Ÿ“– Documentation

    • Document how to use the new registerKubeObjectGlance (thanks to @userAdityaa)
    • Fix typo and broken link to the registerUIPanel docs (thanks to @SinghaAnirban005 )
    • Add architecture section
    • Update the deployment docs to use --dry-run=client (thanks to @MontBlan-c )
    • Add guidance for OIDC's large JWT and ingress header limits

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.32.0 Desktop Apps:

    IMPORTANT: The Windows and Mac applications are not currently being signed. As a result, the OS may warn about them. Learn more about this and how to still run the apps at: https://headlamp.dev/docs/latest/installation/desktop/

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  10. 0.31.0

    Expand

    GitHub Release

    โœจ Enhancements:

    • Revamp Headlamp theme, including a few new ones, and add support for plugin defined themes
    • Experimental feature: Add support for viewing multiple clusters together (select them in the Home view and click View Clusters)
    • Add theme preview/picker UI (thanks to @AllanSlomski )
    • Improve OIDC handling on AKS (thanks to @daviddob )
    • Add support for Node shell; enabled in the cluster settings (thanks to @farodin91 )
    • Add support for Pod eviction and force deletion (thanks to @farodin91 )
    • Allow hiding managed fields when editing a resource (thanks to @farodin91 )
    • Allow direct editing of ConfigMap and Secret data in the UI (i.e. without using the YAML editor)
    • Show list of selected namespaces while hovering (thanks to @upsaurav12 )
    • Add Hindi locale (thanks to @fromsaurav and @DhairyaMajmudar )
    • Add Japanese locale (thanks to @shu-mutou )
    • Add Korean locale (thanks to @sw90lee )
    • Add HPA source to the Map (thanks to @adwait-godbole )
    • Add Simplified Chinese locale (thanks to @warjiang )
    • Truncate long CronJob names (thanks to @ttrubel )
    • Helm Chart: Add support custom deployment annotations (thanks @marginquack )
    • Add cluster's original name to settings
    • Add quick status for containers in list views
    • Show error's reason in the edit dialog when there's a failure
    • Prevent renaming a cluster to a name that's already in use
    • Add setting for sorting sidebar items alphabetically
    • Add horizontal scrollbar on overflow
    • Scale down and rename toggle buttons in Pods' log viewer (thanks to @userAdityaa )
    • Add prettify option for JSON logs (thanks to @userAdityaa )
    • Helm Chart: Add plugin manager sidecar container and support for automatic updates (thanks to @Faakhir30 )

    Node shell in use:

    Image: Node Shell screenshot

    New theme and theme picker:

    Image: Themes UI

    Multi-cluster view of the workloads page:

    Image: Multiple clusters view

    ๐Ÿงฉ Shipped Plugins

    • Update shipped plugin prometheus 0.6.0
      • Add resolution input for metrics
      • Dependency updates
      • Fix fetching the latest time range
    • Update shipped plugin plugin-catalog 0.4.0 (desktop only)
      • Show all installed plugins, even those not installed from the catalog
      • Remove unnecessary button text
      • Dependency updates
      • Inherit color theme for UI elements
    • Update shipped plugin app-catalog 0.6.1 (desktop only)
      • Improve README
      • Update dependencies and gitignore
      • Fix type issues and format files

    ๐Ÿž Bug fixes

    • Fix Helm repo test (thanks to @DhairyaMajmudar )
    • Fix enabling the details side panel by default
    • Fix displaying the actual kubeconfig path associated with clusters
    • Do not keep loading workloads infinitely in the overview when there are none available
    • Fix storybook crashes (thanks to @adityadeshlahre and @userAdityaa )
    • Fix issues with the websocket multiplexor (including changes from @daviddob )
    • Re-enable the websocket multiplexer after bug fixes
    • Fix Map's query params to persist on refresh
    • Fix eslint after Korean locale addition (thanks to @sw90lee )
    • Fix updating the sidebar when the locale is changed
    • Add missing locale mappings for the Table component
    • Fix make frontend-i18n-check command
    • Fix typing the pipe character in the terminal in German keyboards on Mac
    • Fix issues related to proxying requests to certain API servers (to avoid CORS problems)
    • Fix issues when renaming clusters whose original name could be duplicated (i.e. coming from different kubeconfigs)
    • Use a conditional description for the sidebar's collapse/expand button (thanks @Pratik-050 )
    • Fix containers' status color when they were terminated with an error (thanks to @alexandersperling )
    • Simplify/fix many theme/styling related issues

    ๐Ÿ’ป Development

    • Fix many circular dependencies
    • Update Helm's oidc-validator-overrides test template with the latest version (thanks to @marginquack )
    • Plugins can now register UI panels (under, above, or to the sides of the main view)
    • Add a11y checks with Axe in multiple tests
    • Add flag to force watching for plugin changes even when running in-cluster
    • Fix typos in some backend code (thanks to @warjiang )
    • Add comprehensive telemetry and metrics instrumentation (thanks to @DhairyaMajmudar )
    • Fix multiple type issues
    • Add make backend-lint-fix target (thanks to @DhairyaMajmudar )
    • Allow disabling the No button in the ConfirmDialog component
    • Refactor StartPortForward function (thanks to @Whitea029 and @fromsaurav )
    • Improve port forwarding tests (thanks to @AyushSriv06 and @fromsaurav )
    • Skip coverage check when main fails
    • Update headlamp-plugin in all example plugins
    • Fix many e2e tests
    • Add storybook for workloads overview, charts, theme provider, pod logs components (thanks to @userAdityaa )
    • Update Sidebar snapshot tests (thanks to @Pratik-050 )
    • Implement kubeconfig's context filter (thanks to @warjiang )
    • Unify locales from app/ and frontend/ modules
    • Add tests/storybook the Loader, EmptyContent, InnerTable, SectionHeader, and many other components (thanks to @ANIRUDH-SJ )
    • Add docs for AKS with OIDC (thanks to @daviddob and @HarshSrivastava275 )
    • Add test for getThemeName, getToken, and fix linting (thanks to @Pratik-050 )
    • Fix Redux slices to export reducers
    • Refactor MUI named imports from top-level to individual components (including changes from @upsaurav12 )
    • Add new story for Service List and Details components (thanks to @upsaurav12 )
    • Helm Chart: Improve template testing

    ๐Ÿ“– Documentation

    • Update instructions for headlamp mode on mac (thanks to @surajnarwade )
    • Fix link in CONTRIBUTING.md to include https (thanks to @abhi0324 )
    • Clarify OIDC setup for non-Cognito and ingress users on EKS
    • Add tsdocs comments for Tabs and LocaleSelect component (thanks to @userAdityaa )
    • Fix dead link to eslint-config (thanks to @Dumbaz )
    • Add guidance for probe modifications in baser-url
    • Document the react query devtools (thanks to @warjiang )
    • Fix broken links
    • Add links for the plugin repo and ArtifactHub to the README.md file

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.31.0 Desktop Apps:

    IMPORTANT (UNSIGNED APPS): After the move under the Kubernetes SIG UI, we are still finishing some last details on how to sign new releases. So the Windows and Mac desktop versions are not signed/notarized. When running on Windows, you have to choose "More > Run Anyway" when the OS warns you that the application is not signed. On Mac, you have to install the app and then Ctrl+Click it to choose Open from the context menu and then choose to Open the app after the warning. Once we have a way to sign the apps, we will re-upload the assets. We appreciate your patience while we solve this issue.

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  11. 0.30.0

    Expand

    GitHub Release

    โœจ Enhancements:

    • Show resource details in the overlay panel by default (changeable in settings)
    • Now Custom Resources details can be shown in the overlay panel
    • New Traditional Chinese locale available, thanks to @pichuang
    • New Italian locale available, thanks to @M0Rf30
    • Now the status of nodes display the taints

    ReplicaSet details showing in the overlay panel:

    Image: Screenshot of a ReplicaSet details showing in overlay mode

    New Traditional Chinese and Italian locales:

    Image: Screenshot of Headlamp running with the Traditional Chinese locale

    Image: Screenshot of Headlamp running with the Italian locale

    ๐Ÿงฉ Shipped Plugins

    • Update shipped plugin prometheus 0.5.0
      • Allow to configure the subpath
    • Update shipped plugin plugin-catalog 0.2.0 (desktop only)
      • Fix how the official-switch works when it's never been used before

    ๐Ÿž Bug fixes

    • Fix passing token when connecting to the websocket multiplexer
    • Fix running with headless mode, thanks to @DMaxter
    • Fix sources dropdown in the Map view, thanks to @faebr
    • Prevent Map from removing loops, thanks to @faebr

    ๐Ÿ’ป Development

    • Update dependencies
    • Fix make run-backend on Windows
    • Helm: Make in-cluster arg configurable
    • Use deterministic dates in stories
    • Add script to update example plugins' dependencies
    • Allow plugins to update the Map view
    • Misc updates to the example plugins
    • Add ability for plugins to run commands (desktop and after user-consent only)
    • Add ability for plugins to register cluster providers
    • Export cluster actions for plugins to use (actions that wait for a grace-period before happening)
    • Re-enable plugin testing in CI
    • Update container image base to alpine 3.20.6

    ๐Ÿ“– Documentation

    • Add docs about how plugins can use the Map view

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.30.0 Desktop Apps:

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  12. 0.29.0

    Expand

    GitHub Release

    โœจ Enhancements:

    • Add the option to open resource details views in a side pane
      • Can be enabled in the app's settings, from the home view
      • Does not apply to custom resources yet
    • Add support for viewing logs from all pods of the same resource (Deployments, ReplicaSets, ...) in the same dialog
    • Add bulk restart to Deployments, StatefulSets, and DaemonSets. Thanks to @adwait-godbole
    • Helm: Add extended service values. Thanks to @oliverbaehler
    • Wrap text in table cells for better readability. Thanks to @MAVRICK-1
    • Show more detailed errors when listing resources fails
    • Update styling of controls in the Map view
    • Adjust table cells to better fit the contents
    • Support Map related results in the global search
    • Show pods' metrics in the pods list view

    Resource details view in a side pane:

    Image: Screenshot showing the side pane

    Bulk restart of Deployment resources:

    Image: Screenshot showing the bulk restart of Deployments

    Log viewer for multiple pods in a Deployment:

    Image: Screenshot of the log viewer for multiple pods in a Deployment

    ๐Ÿงฉ Shipped plugins

    • Update shipped plugin app-catalog 0.6.0 (desktop only)
      • Fit app icons above their title
      • Display icon only when available
      • Improve search usability and performance
      • Fix a couple of issues in the installation button's style
      • Optimize how charts are fetched

    ๐Ÿž Bug fixes

    • Fix live update of lists and details views (was happening when accessing clusters using a token)
    • Helm: Fix default values
    • Handle error in plugin settings. Thanks to @DhairyaMajmudar
    • Fix incorrect decoding of JWT when checking for its expiration. Thanks to @DhairyaMajmudar
    • Fix sidebar and main scrollbars visibility, so they show under the top bar
    • Fix crash in navigation tabs
    • Fix column order in tables
    • Fix loading kubeconfigs where some contexts were incomplete or contained errors
    • Fix showing editor docs when no resource is found from the editor
    • Fix duplicated entries in sidebar
    • Fix broken links in the cluster overview, related to the events' involved objects
    • Do not show old cluster settings route in search results. Thanks to @Faakhir30
    • Fix honoring user-set zoom levels after restarting the app (desktop only)

    ๐Ÿ’ป Development

    • Add many new Storybook stories for resources who were missing them. Thanks to @DhairyaMajmudar and @adwait-godbole
    • Remove unused NPM package and update dependencies
    • Refactor refreshAndCacheNewToken, charts.tsx, and Notifications. Thanks to @Faakhir30
    • CI: Fail Mac build is signing has been requested and fails
    • CI: Stop automatic PR creation for minikube's addon, since its generation is now part of the minikube repo
    • Add test for getCluster and @apidevtools/swagger-parser. Thanks to @DhairyaMajmudar
    • Remove deprecated linters from golangci-lint
    • Remove obsolete API calls for CronJob resources. Thanks to @adwait-godbole
    • Add run-app and run-only-app Makefile targets. Thanks to @adwait-godbole
    • Misc dependency updates
    • Add support for refetching resource lists on a time interval
    • Ensure go toolchain can be updated automatically
    • Restrict backend to only listen to localhost's requests, when run as an app
    • Add the ability to set which addresses the backend should listen to for requests
    • Allow plugins to process cluster overview charts and add a related example plugin. Thanks to @Faakhir30

    ๐Ÿ“– Documentation

    • Add k0s to platforms. Thanks to @wrkode
    • Fix testing and formatting instructions. Thanks to @Faakhir30
    • Helm: Change ingress.className on README to ingress.ingressClassName. Thanks to @Bemesko
    • Remove redundant commands for building app. Thanks to @adwait-godbole

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.29.0 Desktop Apps:

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)

  13. 0.28.1

    Expand

    GitHub Release

    ๐Ÿž Bug fixes

    • Fix not showing any items because the user's role has no access to listing all namespaces
      • Now it falls back to showing the cluster's default namespace (if set) when there are listing related permissions issues
    • Fix recursive loading issue in port-forward (desktop only)
    • Prevent storing Electron's different preferences profiles each time (desktop only)
    • Fix showing a plugin's payload origin (it was showing the ArtifactHub's package URL but now shows the actual plugin archive URL) (desktop only)
    • Fix other important security issues

    ๐Ÿ’ป Development

    • Refactor some of the plugin manager's code including fixing types

    Container image: :whale: ghcr.io/headlamp-k8s/headlamp:v0.28.1 Desktop Apps:

    :penguin: Flatpak / Linux (AMD64) :penguin: Linux AppImage AMD64, ARM64, ARMv7l :penguin: Linux Tarball AMD64, ARM64, ARMv7l :penguin: Debian / Linux AMD64 :green_apple: Mac (AMD64) :green_apple: Mac (ARM/M1) :blue_square: Windows (AMD64)