Lens 5

IMPORTANT! Lens 5 has been officially released! Get started with Lens 5 by downloading and installing the latest version from Lens website. The content below on this Lens 5 Beta page is not applicable anymore.

Lens 5 Beta

Lens 5 is the new major version of Lens IDE. This is the dedicated page for Lens 5 BETA that is an early access version designed for people to try out and provide feedback. Please note many of the features are still missing or they are incomplete, user interface is not 100% complete or polished, and there are number of known issues.

We do not recommend using Lens 5 Beta for production use cases. It’s early access product and under heavy development, but we appreciate all the feedback and testing to make the final product beautiful. Please join dedicated Lens 5 Beta Slack channel #lens5beta on our community Slack to provide any feedback!


Here’s the overview of Lens 5 major new features:

You can also find some additional details about these features on https://k8slens.dev website.



  1. Download Lens 5 Beta for macOS.
  2. Open the browser’s download list and locate the downloaded archive.
  3. Select the ‘magnifying glass’ icon to open the archive in Finder.
  4. Double-click Lens-{version}.dmg and drag Lens.app to the Applications folder, making it available in the macOS Launchpad.
  5. Add Lens to your Dock by right-clicking on the icon to bring up the context menu and choosing Options, Keep in Dock.


  1. Download the Lens 5 Beta installer for Windows.
  2. Once it is downloaded, run the installer Lens-Setup-{version}.exe. This will only take a minute.
  3. By default, Lens is installed under C:\users\{username}\AppData\Local\Programs\Lens.


After installing Lens from AppImage the following will need to be done to allow protocol handling. This assumes that your linux distribution uses xdg-open and the xdg-* suite of programs for determining which application can handle custom URIs.

  1. Create a file called lens.desktop in either ~/.local/share/applications/ or /usr/share/applications (if you have permissions and are installing Lens for all users).
  2. That file should have the following contents, with <path/to/executable> being the absolute path to where you have installed the unpacked Lens executable:
     [Desktop Entry]
     Exec=<path/to/executable> %U
     Comment=Lens - The Kubernetes IDE
  3. Then run the following command:
     xdg-settings set default-url-scheme-handler lens lens.desktop
  4. If that succeeds (exits with code 0) then your Lens install should be set up to handle lens:// URIs.

Getting Started

Creating a Lens Space account

In order to share a cluster with a team, you will first need to create a Lens Spaces account:

Creating a Lens Space / Add Cluster

Once logged in create a Space in Lens 5 Beta and add your cluster:

Inviting members to your Space

Invite members to your Space to give them access to your cluster:

Accepting a Space Invite:

For an invitee to access your cluster they need to accept your invitation:

Adding resources to Hotbar:

To create a workflow add a cluster or resource to Hotbar:

Creating a team within your Space:

To create a team that can access your Space:

More features coming soon…

Known Issues

To fully restart Lens please close it from the tray icon. If in doubt please check your activity/process monitor to confirm that the Lens process has been removed.

To help us with any issues you see during the beta of Lens Spaces please review the below two documentation links which detail how to capture more detailed logs: