litelens

README

Litelens

LiteLens is a lightweight, native desktop dashboard for managing Kubernetes clusters. It's built with Wails (Go backend + React webview, no Electron), so it stays small and fast while giving you a clean, modern watch-based UI over your cluster.

https://github.com/user-attachments/assets/7afe5c08-fb14-4ca1-ac33-4a2cbe8d2849

Installation

Homebrew (macOS)

LiteLens is distributed via a custom Homebrew tap (not homebrew-core), so brew search litelens won't find it — tap it explicitly first:

brew tap litelensapp/homebrew-litelens
brew trust litelensapp/litelens/litelens
brew install litelensapp/litelens/litelens

If you install via Homebrew, prefer brew upgrade litelens over the in-app updater to keep versions in sync.

APT (Debian/Ubuntu)

LiteLens publishes .deb packages to a self-hosted APT repository, signed with a dedicated GPG key. Pick the command block matching your Ubuntu release:

Ubuntu 24.04 (noble)

curl -fsSL https://litelensapp.github.io/litelens-apt/keys/litelens-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/litelens-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/litelens-archive-keyring.gpg] https://litelensapp.github.io/litelens-apt noble main" | sudo tee /etc/apt/sources.list.d/litelens.list
sudo apt-get update && sudo apt-get install litelens

Ubuntu 22.04 (jammy)

curl -fsSL https://litelensapp.github.io/litelens-apt/keys/litelens-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/litelens-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/litelens-archive-keyring.gpg] https://litelensapp.github.io/litelens-apt jammy main" | sudo tee /etc/apt/sources.list.d/litelens.list
sudo apt-get update && sudo apt-get install litelens

Ubuntu 20.04 (focal)

curl -fsSL https://litelensapp.github.io/litelens-apt/keys/litelens-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/litelens-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/litelens-archive-keyring.gpg] https://litelensapp.github.io/litelens-apt focal main" | sudo tee /etc/apt/sources.list.d/litelens.list
sudo apt-get update && sudo apt-get install litelens

If you install via apt, prefer apt upgrade over the in-app updater — the in-app updater detects apt-managed installs and silently defers to apt rather than prompting.

Manual (Linux + MacOS)

curl -fsSL "https://raw.githubusercontent.com/litelensapp/litelens/main/scripts/install.sh" | bash

Uninstallation

Homebrew (macOS)

brew uninstall litelensapp/litelens/litelens

APT (Debian/Ubuntu)

sudo apt remove litelens

This preserves ~/.litelens (settings, installed plugins). To wipe it too:

sudo apt remove --purge litelens

Manual (Linux + MacOS)

curl -fsSL "https://raw.githubusercontent.com/litelensapp/litelens/main/scripts/uninstall.sh" | bash

This preserves ~/.litelens (settings, installed plugins). To wipe it too:

curl -fsSL "https://raw.githubusercontent.com/litelensapp/litelens/main/scripts/uninstall.sh" | bash -s -- cleanup

Contributing

We welcome contributions! See CONTRIBUTING.md for setup, testing, and PR guidelines. Please also review our Code of Conduct and Security Policy.

License

LiteLens is licensed under the Apache License 2.0.