Install Lens Desktop#

Lens Desktop is lightweight and simple to install on all major platforms. You can find all installation options on the Lens website.

System requirements#

Before you proceed with Lens Desktop installation, verify that your system meets the system requirements.

Hardware requirements#

Minimum hardware requirements:

2 GHz or faster processor
1 GB of RAM
1 GB of disk space

Platforms#

Lens has been tested on the following platforms:

macOS
Windows
Linux

Install Lens Desktop on macOS#

Download Lens Desktop from the Lens web site for macOS.
Double-click Lens-{version}.dmg and drag Lens.app to the Applications folder, making it available in the macOS Launchpad.
Add Lens to your Dock by right-clicking on the icon to bring up the context menu and choosing Options, Keep in Dock.

Install Lens Desktop on Windows#

Download the Lens Desktop installer for Windows.
Install Lens Desktop by running the Lens-Setup-{version}.exe installer. By default, Lens Desktop installs under C:\users\{username}\AppData\Local\Programs\Lens.

Install Lens Desktop on Linux#

You have the following downloading options for Linux:

.rpm and .deb files
AppImage file
.snap file

Default package formats#

This example shows how to install Lens Desktop on Ubuntu 20.04:

Download the .deb file here.
In the Linux command line, type the following:
```
sudo apt install <path-to-deb-file>
```
You can also use one of the applications for .deb file installations.

Note

For RPM-based distributions, the procedure is similar with slight differencies in terminal commands.

AppImage#

Download the AppImage file here.
Navigate to the directory where you have the file downloaded and right-click the AppImage file and select Properties > Permissions.
Select the Allow executing file as a program check box.

Note

Some file managers might offer to unselect the Is executable check box or other similar actions.
In the Linux command line, navigate to the directory where you have the file downloaded and type the following commands:
```
chmod +x <file-name.AppImage>
./<file-name.AppImage>
```

After installing Lens manually (not using a package manager file such as .deb or .rpm) 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.

Create a file called lens.desktop in one of the following directions:
~/.local/share/applications/ to install for all users
/usr/share/applications to install for your user

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]
Name=Lens
Exec=<path/to/executable> %U
Terminal=false
Type=Application
Icon=lens
StartupWMClass=Lens
Comment=Lens - The Kubernetes IDE
MimeType=x-scheme-handler/lens;
Categories=Network;

Then run the following command:

xdg-settings set default-url-scheme-handler lens lens.desktop

If that succeeds (exits with code 0) then your Lens install should be set up to handle lens:// URIs.

Snap#

Download the Lens package for Snap.

In the Linux command line, type the following:

sudo snap install Lens-{version}.amd64.snap --dangerous --classic

Updates#

Lens Desktop supports auto-updating. When a new release is available, a notification appears in the application.

Note

Auto-updates are available only for exe, dmg, and AppImage installations. Update other distributions manually.

See Lens release notes to find information about features, maintenance and so on.

Backup and restore data#

When updating to a major Lens Desktop version, user data such as clusters, preferences, and so on, migrates to new data structures. However, we recommend you to back up user data which is by default stored in the following directions:

MacOS
~/Library/Application Support/Lens/
Windows
%APPDATA%\Lens\
Linux
~/.config/Lens/ or $XDG_CONFIG_HOME/Lens

Launch Lens Desktop