Skip to content

freelensapp/freelens

Repository files navigation

Freelens

Home license release npm Unit tests Integration tests

Freelens is Free and Open-Source UI for Kubernetes. It is a standalone application for MacOS, Windows, and Linux operating systems.

Screenshot

Downloads

See the releases page and download the right package for your system.

MacOS

Download either PKG (installer) or DMG (image) package from the releases page. Both arm64 (M1 chip or newer) and amd64 (Intel) variants are available.

All binary packages are built on MacOS 14 and should be compatible with new systems.

Homebrew

Run from the command line:

brew tap freelensapp/tap
brew install --cask freelens

Linux

Download DEB or RPM (package) or AppImage (executable) from the releases page. Both arm64 (aarch64) and amd64 (x86_64) variants are available.

All binary packages are built on Ubuntu 20.04 and should be compatible with new systems.

AppImage

Linux AppImage file requires libz.so and libfuse.so.2. You can add them, ie. by running:

sudo ln -fs /usr/lib/*/libz.so.1 /usr/local/lib/libz.so
sudo ldconfig
sudo apt install libfuse2

Run the application with additional arguments:

./Freelens*.AppImage --no-sandbox --ozone-platform-hint=auto

APT repository

Run from the command line:

sudo mkdir -p /etc/apt/keyrings
curl -L https://raw.githubusercontent.com/freelensapp/freelens/refs/heads/main/freelens/build/apt/freelens.asc | sudo tee /etc/apt/keyrings/freelens.asc
curl -L https://raw.githubusercontent.com/freelensapp/freelens/refs/heads/main/freelens/build/apt/freelens.sources | sudo tee /etc/apt/sources.list.d/freelens.sources
sudo apt update
sudo apt install freelens

Windows

Download EXE or MSI installers from the releases page.

The EXE and MSI are not yet signed then you must override Microsoft Defender SmartScreen to install them.

Only x64 (amd64) version of the Windows binaries are provided.

WinGet

Run from the command line:

winget install Freelensapp.Freelens

It supports --silent option for suppressing all UI.

Node-Pod-Menu extension

To view container logs and shell into them and nodes you can install the very useful extension freelens-node-pod-menu.

To install it, open Freelens -> Extensions menu, then put @freelensapp/freelens-node-pod-menu name as an input and push the Install button.

Development

Read DEVELOPMENT.md to see how to build the application from the source.

Contributing

Anyone is welcome to collaborate to advance the Freelens project.

License

This repository is a fork of Open Lens, core of Lens Desktop, with the aim of carrying forward its open source version.

Copyright (c) 2024-2025 Freelens Authors.

Copyright (c) 2022 OpenLens Authors.

MIT License