The first feature release after v2.0.0, with the security fixes of Node v24.22.3.
It is a release full of fixes and new features made by the wonderful Freelens community, and special thanks go to everyone who contributed to it.
What's new:
v2.1.0 brings themes as files with eight built-in themes, a choice of accent color and zoom level, overviews as cards, combined logs for the pods of a workload, debugging a pod in an ephemeral container, copying the values of the details in one click, the certificate details of secrets, the mutating admission policies, metrics for GKE clusters from Google Managed Prometheus, and Helm releases read straight from the Kubernetes API. The extension API gains a credential store encrypted with the secret store of the system, the certificate view of secrets, the overview cards, the copy controls and the generic components the views of Freelens are built from. It also fixes the connection to clusters whose kubeconfig has a colon in its file name or is written in UTF-16, Windows shells given by name, custom extension registries served under a path, the metrics of several setups, and several issues of the logs, the sidebar and the details.
New Features
- Themes are YAML files with a dark and a light variant, chosen in Preferences → Personalization. Eight are built in: Freelens, Ayu, Ayu Mirage, Dracula, Graphite, Catppuccin, Solarized and High Contrast, whose text reaches a contrast of 7:1. A theme can be exported, and imported from a file or a URL. See the theme format. See #3029, #3035, #3036, #3037, #3038, #3040, #3041, #3043, #3045, #3049, #3046, #3052, #3047, #3054, #3053, #3055
- The accent color can be chosen for the dark and the light variant, from named swatches or as any color, with a palette and a field for its hex code. See #1280, #1431, #3032, #3033, #3034
- Preferences → Personalization sets the zoom level, from 67% to 200%, and keeps it across restarts. See #3044, #3050
- The cluster overview and the workloads overview can show cards that state the numbers, with line charts for the cluster metrics, instead of the ring and pie charts. Overview style in Preferences → Personalization chooses them. See #3042, #3051
- Combined logs for a workload: the Logs item of a Deployment, DaemonSet, StatefulSet, ReplicaSet or Job opens one tab with the logs of all its pods, interleaved by time, each pod in a colour of its own. A new preference under Kubernetes sets how many pods such a tab reads. See #687, #2418, #3004, #3006
- The details of a secret show the certificates it holds in PEM: subject, issuer, DNS names and IP addresses, serial number, validity, and the expiry, marked when it is near or past. The certificates are parsed in the main process. See #3002, #3003, #3008, #3010
- MutatingAdmissionPolicies and MutatingAdmissionPolicyBindings under Config, next to the validating ones, on clusters that serve them as v1, v1beta1 or v1alpha1. The details of the validating and mutating policies and bindings show their namespace and object selectors. See #2434, #2511
- The Google Managed Prometheus provider reads the GKE system metrics, which GKE collects for every cluster at no extra charge, through the query frontend of Google Cloud Managed Service for Prometheus. The cluster, nodes, pods, workloads and PVCs get their charts without node-exporter or kube-state-metrics. Auto Detect finds the frontend, and the Metrics settings of the cluster link to Google's instructions for deploying it. See #3097, #3099, #3107
- The ingresses list has a Class column, and the details of an ingress show its IngressClass, with a link when it comes from
spec.ingressClassName. See #2936, #2945 - The General settings of a cluster set an Icon Label of up to four characters and an Icon Color, so that the clusters of one environment look alike in every region. See #1908, #2994
- The pods list and the pods of a workload have a Ports column, searchable, with the name and protocol of each port in its tooltip. See #2827
- The nodes list has a Kernel Version column, hidden until it is enabled in the column menu. See #2411
- The details of an object show its Last Applied Configuration, from the annotation of
kubectl apply, as YAML. The default container of a pod, from thekubectl.kubernetes.io/default-containerannotation, is marked in the pod details, the pod menu and the logs, and is the one Shell, Attach and Logs open. See #2988, #2989 - Debug... in the menu of a pod adds an ephemeral container to it with
kubectl debug, from the image, profile, environment variables and custom container spec given in its dialog, and opens a terminal attached to it. Closing the terminal leaves the container running: Attach and Stop in the details of the pod connect to it again or stop it. The default image is a setting of the cluster, next to the image of the node shell. See #962, #2453, #3127 - The values in the details have a copy icon: the data of a ConfigMap, the values of a Helm release, the validation of a CustomResourceDefinition, the affinities of a pod, the managed fields and the last applied configuration of any object, and the keys of a Secret, whose value is copied decoded whether it is shown or not. See #2992, #3117
- The menu of a dock tab can close the tabs to the left of it. See #2508, #2995
- The YAML editor folds a key together with the list written at its indentation, such as
containers:orvolumes:, as well as each item of the list. See #2524, #2996 - The Help menu has a "What's new" item that opens the release notes of the running version. See #2909, #2910
Extensions API
Common.Credentials.forExtension(this)keeps the tokens and passwords of an extension encrypted at rest with ElectronsafeStorage, in both processes, bound to the extension instance and removed when the extension is uninstalled. It promises encryption at rest only: it is not a boundary between extensions. On Linux it is available with libsecret or KWallet, and a desktop Electron does not recognise can name one with--password-store. See the contract. See #2782, #3011, #3012Renderer.Component.SecretCertificatesrenders the certificate section of the secret details for the data of any secret, such as thecertSecretRefof a Flux source, with the parsing done by the host. See #3008, #3010Renderer.Component.CapacityCardandRenderer.Component.StatusCardrender the cards of the overviews from the data of an extension, andCommon.App.Preferences.getOverviewStyle()tells whether the user chose Cards or Charts. See #3042, #3051Renderer.Component.CopyToClipboardIcon,Renderer.Component.CopyableMonacoEditorandRenderer.Component.CopyableInputcopy a value as the details of Freelens do, the editor and the input with an unsaved edit included. See the contract. See #2992, #3117Renderer.Componentexports the generic components the views of Freelens are built from:ErrorBoundary,Animate,ResizingAnchor,ColorSwatch,ColorSwatchGroup,CustomColorSwatch,OrderableListandOrderableItem, andVirtualListagain, whosescrollToItemtakes aVirtualListAligninstead of a type ofreact-window. Their classes are global, so that an extension can restyle them. See #3121, #3123Renderer.Component.ImageReferenceshows an image as the details of a pod do: a badge with the image as the object names it, and the digest of the image the node pulled as its tooltip.K8sApitypesPodContainerStatus.volumeMounts, which carries the digest of an image volume. See the contract. See #3130Node.getWarningConditions()reports only the conditions Kubernetes defines:Readywhen it is not true, and the pressure conditions andNetworkUnavailablewhen they are. A condition such asEtcdIsVoterof k3s is no longer a warning. See #2924Common.Typesnames the helper types of the signatures of the API:JsonValue,PartialDeep,ReadonlyDeep,RequireAtLeastOne,RequireExactlyOne,SetRequiredandValueOf.type-festis no longer a dependency of@freelensapp/extensions: an extension that imports it declares it in its owndevDependencies. See #3064, #3065- The declared
orderNumberofclusterPageMenusorders the menus of an extension, and their children, in the sidebar again. See #2959, #2987 K8sApihas theMutatingAdmissionPolicyandMutatingAdmissionPolicyBindingmodels,Node.getKernelVersion(),Ingress.getIngressClassName(),PodSpec.ostyped withOSNameandPodOS,podsStore.getPodsByNamespace()andpodsStore.getPodsByPersistentVolumeClaim(), and the pod lookups ofpodsStore,jobStore.getJobsByOwner()and thegetByIdandgetByPathof every store read an index instead of scanning the store.isAllowedResourcefinds the admissionregistration resources, which it looked up under a wrong API group before. See #2411, #2453, #2511, #2945, #3066, #3067, #3069, #3072, #3074Common.Util.sortCompareand the stores sort names with numbers by the value of the number, and lowercase and uppercase letters together. See #2974Renderer.Component.Chart,BarChartandPieChartkeep the datasets they draw across updates, so a chart no longer replays its opening animation when its data changes, and a field that the new data of a dataset lacks is no longer kept from the previous data. See #3128, #3129- The agent skills for extension authors, to create an extension and to port one to v2, are a plugin of Claude Code in this repository. See #2997
Improvements
- Helm releases are read from the Kubernetes API instead of the
helmbinary, which still installs, upgrades, rolls back and uninstalls them. The list of releases watches only the metadata of the objects of Helm instead of every Secret, and the details of a release no longer list every release of its namespace. See #2972, #2973, #2990, #3093, #3094, #3095 - The workload lists and statuses find the pods of a workload, a node, a namespace or a PersistentVolumeClaim in an index, and the CronJobs find their jobs in one, which speeds up the workload lists, the Persistent Volume Claims list and the CronJobs list on large clusters. The namespace filter, the warnings of the cluster overview and the lookups of an object by its path, such as the menu of every row of a list, no longer scan the whole store. See #3066, #3067, #3068, #3069, #3071, #3072, #3073, #3074
- After a cluster outage the watches reconnect as soon as the cluster answers, and a watch that keeps failing backs off up to a minute, instead of every watch retrying every 5 seconds. See #3075, #3076
- Every logs tab keeps at most 100,000 lines, the tab of a single pod included, which grew without a limit while it stayed open. See #3079, #3080
- Scrolling a logs tab to the top merges the older lines into the tab instead of replacing it, so the lines written before a log rotation are no longer lost from it. When a rotation or a restart of the container falls between two refreshes, the tab marks the place where some lines may be missing. See #3081, #3082, #3084
- The application is smaller: the renderer bundle is 3 MB smaller without the API clients and the HTTP client of
@kubernetes/client-node, and the package leaves out the TypeScript, CSS and HTML language services of Monaco, which Freelens does not use. See #3087, #3088, #3089, #3090, #3091, #3092 - Names with numbers sort by the value of the number, so
job-2comes beforejob-10. See #2974 - The Terminal Shell Path setting says which shell the terminals start, or that the shell is not found and what to give instead. See #3001, #3019
- The node option of the Cluster overview says "Control plane" instead of "Master". A choice saved before the update keeps working. See #2892, #2893
- The log of the main process says why the metrics could not be loaded, with the status and the description of the failed query. See #2461, #2984
- The metric charts show the values under the cursor anywhere on the chart, break their lines across periods without data, and align the range of their queries to the step. See #2922, #2943
- The Disk column of the nodes shows the used and the total size as text, as the CPU and Memory columns do. See #3108
- The OCI Reference of an image volume in the details of a pod is a badge like the Image of a container, with the digest of the image as its tooltip on clusters that report it (the
ImageVolumeWithDigestfeature gate). See #3130 - A view keeps the metrics that Prometheus answered when it rejects some of the other queries. See #3110
- Zoom In also answers Ctrl+= (Cmd+= on macOS) and the + key of the numeric keypad, and Zoom Out its − key. See #2426
- The Shell and Attach items of a pod open a terminal that runs
kubectlitself instead of typing the command into a local shell, and they open again after a restart. Closing a terminal tab no longer typesexitinto it: closing a pod shell ends its shell in the container, and closing an Attach tab only detaches. See #3111, #3112 - Every release has an SBOM in the CycloneDX format next to the SPDX one.
Fixes
- The RPM package installs on RHEL 10 and its rebuilds (such as Rocky Linux 10 and AlmaLinux 10) again: it no longer requires
libXScrnSaver, which these distributions do not provide and nothing in Freelens uses. The DEB package no longer requireslibxss1for the same reason. See #2896 - A cluster from a kubeconfig with a colon in its file name connects, instead of failing with
context ... does not exist. See #2895, #2919 - A kubeconfig in UTF-16 with a byte order mark, as Windows PowerShell 5.1 writes it, is read by the folder sync instead of being skipped. See #2917, #2939
- On Windows, a terminal whose shell is given by name only, such as
wsl.exe, starts when Freelens runs fromC:\Windows\System32, instead of failing withFile not found. See #2918, #2941 - The details of a ConfigMap or a Secret follow the changes made in the cluster, and saving no longer overwrites such a change with the values the panel opened with. See #3000, #3015
- With a custom extension registry served under a path, such as an Artifactory npm repository, extensions install from it, and their archives are downloaded from it instead of from registry.npmjs.org. An invalid registry URL no longer leaves the install form disabled until a restart. See #2944, #2948, #3028, #3030, #3031
- A second pod logs tab shows its own logs instead of following the first one. See #2960, #2961
- The pod logs list follows its new lines again, with word wrap on and off. See #2963, #2964
- A log line that does not start with a timestamp, such as what a progress bar writes after a carriage return, no longer drops lines, stops the refresh of the tab or crashes the list. See #2955, #2957
- An empty log line, or one that ends with a space, is no longer shown twice. See #3026, #3027
- The node shell starts on a node whose host has no
bash, withsh. See #2826, #3063 - Dragging a section of the cluster sidebar keeps it where it is dropped, also with an extension that was uninstalled or that has more than one top-level menu. See #2983, #2985
- The details of a RuntimeClass with a fixed overhead, such as the ones of kata-containers, no longer crash the application. See #1172, #2986
- The details of a pod without a service account, such as a static pod of the control plane, no longer show an empty Service Account row. See #813, #3131
- The padding inside the details drawer, the search input and the terminal no longer changes the spacing of the elements in them. See #2991, #2993
- A store file is written in one go, so the hotbars file never holds a new list of hotbars with the active hotbar of the old one. See #3085, #3086
- The resource requests and limits of the cluster count only the pods that are pending or running. See #2970
- The node metrics of the Prometheus Operator provider follow a pod that moves to another node. See #2923
- A node is marked with a warning only for the conditions Kubernetes defines, so a k3s node is no longer marked for
EtcdIsVoter. See #2924 - A user who may read the metrics of the pods only in some namespaces sees them for those namespaces. See #2921
- The ring charts of the overviews no longer replay their opening animation at every update, such as a change of a pod or a new reading of the metrics, and the tooltip of a ring left without objects says Empty instead of the last status it had. See #3128, #3129
- Disconnecting a cluster no longer logs errors of a refresh of its permissions, and a request that the client cancels is no longer logged as an error of the proxy. See #2886, #2887, #3116, #3119, #3120
Security
- Node v24.22.3 in Electron v44.11.4 fixes vulnerabilities of
http2andtls, nine of them rated High. The main process uses both in its connections to the clusters. See #2937 - An extension installed unverified, without a checksum beside its archive or an integrity in the metadata of the registry, stays disabled until the user enables it on the Extensions page. See #3039, #3048
- Every route of the local proxy needs its token, except the renderer's files and
/version, and the proxy decides which on the same normalized path it routes by. See #3103 - The renderer's files are served only from inside their directory, which is checked as a path rather than by the prefix of its name. See #3104
- Security updates of joi and fast-xml-parser. See #2894, #2981
Advisories
- GHSA-vq7j-r44j-x23r (high): the local proxy skipped its token, host and origin checks for a request whose path was not spelled canonically, such as
/./api/…, so a local process without the token could reach the routes of the main process that act on the clusters.
Updates
- 48 dependency updates in total, including 2 security updates (joi and fast-xml-parser).
- Uses Electron v44.11.5 with Chromium 152.0.7977.169 and Node v24.22.3
- Has bundled kubectl v1.37.2, Helm v4.3.2 and freelens-k8s-proxy v2.0.1, and downloads kubectl v1.34.13, v1.35.10 and v1.36.6 for the clusters of those versions. See #2884, #3014, #3059