Skip to content

Technical FAQ#

What operating systems does Lens support?#

Lens supports macOS, Windows and Linux operating systems. For Linux there are Snap and AppImage versions. For macOS there are DMG and Homebrew options.

Lens application is not opening, what might be wrong?#

When Lens is started, it will start HTTP proxy server on the background and requires that operating system allows to start listening to some free port. You can see the port allocated for Lens from application logs. Lens expects also that localhost DNS points to address.

Why can't I add any clusters?#

When adding new clusters, a valid Kubeconfig file is required. Please check that all contexts present in Kubeconfig file are valid.

Why Cluster dashboard is not opening?#

To see Cluster dashboard properly, Kubernetes cluster must be reachable either directly from your computer or via HTTP proxy. You can configure HTTP proxy in Cluster Settings. Also, provided credentials in Kubeconfig must be valid. If Kubeconfig uses exec command, the binary must be available in global PATH or absolute path must be used. Lens application can't see PATH modifications made by any shell init scripts. There might be also some issues on the Snap version if the exec binary is installed also from Snap and requires additional symlinking, please see #699.

Why I don't see anything on Cluster dashboard?#

Users will see on Cluster dashboard only those resources that they are allowed to see (RBAC). Lens requires that the user has access at least to one namespace. Lens tries first fetch namespaces from Kubernetes API. If the user is not allowed to list namespaces, allowed namespaces can be configured in Cluster settings or in Kubeconfig.

Why I don't see any metrics or some of the metrics are not working?#

In order to display cluster metrics, Lens requires that Prometheus is running in the cluster. You can install Prometheus in Cluster settings if needed.

Lens tries to detect Prometheus installation automatically. If it fails to detect the installation properly, you can configure Prometheus service address in Cluster settings. If some of the metrics are not displayed correctly, you can see queries that Lens is using here and adapt your Prometheus configuration to support those queries. Please refer Prometheus documentation or your Prometheus installer documentation how to do this.

Kubectl is not working in Lens terminal, what should I do?#

Lens tries to download correct Kubectl version for the cluster and use that in Lens terminal. Some operating systems (namely Windows) might have restrictions set that prevent downloading and executing binaries from the default location that Lens is using. You can change the directory where Lens downloads the binaries in App Preferences. It's also possible to change the Download mirror to use Azure if default Google is not reachable from your network. If downloading Kubectl is not an option for you, you can define the path to pre-installed Kubectl on your machine and Lens will use that binary instead.

How can I configure Helm repositories?#

Lens comes with bundled Helm 3 binary and Lens will add by default bitnami repository if no other repositories are configured. You can add more repositories from Artifact HUB in App preferences. At this moment it is not possible to add private repositories. Those and other public repositories can be added manually via command line.

Where can I find application logs?#

Lens will store application logs to following locations depending on your operating system: - macOS: ~/Library/Logs/Lens/ - Windows: %USERPROFILE%\AppData\Roaming\Lens\logs\ - Linux: ~/.config/Lens/logs/

How can I see more verbose logs?#

You can start Lens application in debug mode from the command line to see more verbose logs. To start application in debug mode, please provide DEBUG=true environment variable and before starting the application, for example: DEBUG=TRUE /Applications/

Why Lens window rendering is broken?#

The macOS users can encounter visual bug with fuzzy lines appeared while connected to external 4K display. The same thing can happen with any of tje Electron applications or Chrome itself.

fuzzy lines

As a temporary workaround there is a possibility to disable Chromium GPU acceleration. To do this for Lens, you need to provide LENS_DISABLE_GPU=true env variable and relaunch app.

First, open .bash_profile file from your terminal

open -a ~/.bash_profile

Then, add this line

export LENS_DISABLE_GPU=true

Does Lens work over X11?#

Lens does not specifically support working over X11, but it has been confirmed to run on a Linux system with the UI served on macOS via XQuartz. A good network connection is required for a responsive UI. If a blank X Window is encountered on startup try setting the following on the remote system, and then restart Lens:

export QT_X11_NO_MITSHM=1

This is a workaround for a possible shared memory issue in Electron/Chromium.

Why does the in-app support chat not work?#

It may be caused by your firewall or corporate proxy. Make sure that the following endpoints are not blocked:

  • https://*