# Freelens

Free Kubernetes desktop GUI for inspecting workloads, logs, metrics and resources across your existing clusters.

> This is the Markdown version of the Freelens page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/freelens>

- **Latest version**: `2.1.0`
- **Developer**: Freelens Authors
- **Homepage**: <https://freelens.app/>
- **Categories**: [Virtualization & Containers](https://opennavo.com/categories/virtualization)
- **Install**: `brew install --cask freelens`
- **30-day installs**: 1,336
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/freelensapp/freelens/releases/download/v2.1.0/Freelens-2.1.0-macos-arm64.dmg>
- **SHA-256**: `d4e0155c429e828edd5c0fdd111e0dfd21810e638d2baac951a677f7d89e6300`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "Freelens.app"
      ],
      "target": "/Applications/Freelens.app"
    },
    "phase": "install",
    "sources": [
      "Freelens.app"
    ],
    "target": "/Applications/Freelens.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/app.freelens.freelens.sfl*",
            "~/Library/Application Support/Freelens",
            "~/Library/Logs/Freelens",
            "~/Library/Preferences/app.freelens.Freelens.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Freelens is a free, open-source desktop interface for exploring and managing Kubernetes clusters. It is designed for developers, platform engineers and cluster administrators who want visual access to workloads, configuration, networking, storage, events and access-control resources alongside terminal-based tools.

### Cluster visibility and management
Connect existing Kubernetes contexts through kubeconfig to browse nodes, namespaces, pods, deployments and other resources. Workload views, pod logs, shell and attach actions, port forwarding, resource editing and Helm management support investigation and day-to-day administration. Metrics depend on the cluster's available metrics-server or Prometheus-compatible data and your access to them; installing the desktop client does not automatically install a monitoring stack in every cluster.

Freelens is a community fork of OpenLens, the open-source core of Lens Desktop. It carries that code forward as a separate application. It is not a paid Lens subscription, a Mirantis account entitlement or a guarantee that every commercial Lens feature or third-party extension is included. Optional extensions have their own compatibility, permissions and service requirements.

### Credentials, tools and permissions
You need an existing reachable Kubernetes API endpoint and valid cluster credentials. The client uses kubeconfig contexts, commonly from ~/.kube/config; selected contexts determine which cluster and identity an operation targets. Protect kubeconfig files, embedded tokens, certificates and authentication plugins as credentials. Cloud-provider authentication can require separately installed provider tools and a provider account; a bundled kubectl does not replace every external credential helper.

Version 1.10.3 bundles kubectl 1.36.2 and Helm 4.2.2. Their paths and related preferences can be configured, and external binary failures are reported by the application. Binary selection and Kubernetes version compatibility should be checked for the cluster you administer. A separate Homebrew kubectl or Helm installation is not a prerequisite solely because these tools exist in the interface. The terminal can invoke local programs with your user permissions, while pod shell, attach, Helm changes, resource editing and deletion can perform remote actions using your Kubernetes authorization.

Kubernetes RBAC and server admission policies still control permitted actions. Freelens does not grant cluster-admin permissions or bypass a cluster's authentication. Use the intended context and namespace before changing resources: a desktop GUI action can affect a production cluster. Grant only the local file/network access and remote privileges required for your work. Running the Mac application does not ordinarily require making every cluster credential an administrator credential.

### Installation and platforms
Install the freelens Homebrew Cask or use the official DMG or PKG for your Mac architecture. macOS 12 or later is required by both the official README and Cask dependency. Apple Silicon uses the arm64 build, while Intel uses the amd64 build. The recorded 1.10.3 arm64 DMG is 199,473,494 bytes by official HTTP HEAD; this is installer size rather than installed disk use. The stable Cask conflicts with freelens@nightly, so choose one channel rather than treating both as interchangeable installations.

The project also distributes Windows and Linux packages separately. The desktop application is installed on your workstation, not as a Kubernetes server component. It does not create a cloud account, supply a managed cluster or include hosted compute capacity. Internet access may be needed for updates, tool downloads, authentication or remote clusters; private clusters may require your organization's network route or VPN.

### License, fees and optional services
Freelens is free under the MIT license, with notices for Freelens and OpenLens authors. No paid Freelens desktop license or Lens account is required for the base client. Donations and community funding are optional. Kubernetes hosting, cloud providers, commercial support and optional extensions or model APIs may have separate charges and terms; they are not included merely by installing the app.

The client handles local credentials and connects to the clusters and services you configure. Logs, terminal output, resource manifests and screenshots can reveal infrastructure details or secrets, so share only appropriate material. The official screenshot is a historical illustrative Mac workload/log view rather than proof of the exact 1.10.3 interface or a hosted cluster included with the product.

Official sources: [Tagged README](https://github.com/freelensapp/freelens/tree/v1.10.3), [MIT license](https://github.com/freelensapp/freelens/blob/v1.10.3/LICENSE), [Releases](https://github.com/freelensapp/freelens/releases), [Project wiki](https://github.com/freelensapp/freelens/wiki).

## System requirements

- macOS 13 or later · Version: 2.1.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · Checked 2026-11-22
  - <https://github.com/freelensapp/freelens/releases/download/v2.1.0/Freelens-2.1.0-macos-amd64.dmg>
  - SHA-256: `f283b3dea60206e0bc60b1941091aa63635a909d424e5fc89c2c115e2c3791b3`
- macOS 13 or later · Version: 2.1.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · Checked 2026-11-22
  - <https://github.com/freelensapp/freelens/releases/download/v2.1.0/Freelens-2.1.0-macos-arm64.dmg>
  - SHA-256: `d4e0155c429e828edd5c0fdd111e0dfd21810e638d2baac951a677f7d89e6300`

## Freelens security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/freelensapp/freelens> · Open source: Yes — <https://github.com/freelensapp/freelens> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask freelens`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask freelens`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/app.freelens.freelens.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Freelens` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Logs/Freelens` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/app.freelens.Freelens.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 2.1.0 (2026-11-21)

Freelens 2.1.0 adds file-based themes, combined pod logs and pod debugging for people who manage Kubernetes clusters.

Freelens 2.1.0 was released on November 21, 2026. It adds file-based themes, combined pod logs and pod debugging for people who manage Kubernetes clusters, and includes the security fixes from Node 24.22.3.

- Eight built-in themes, or import one from a file or a URL.
- Choose an accent color, and a zoom level from 67% to 200%.
- A workload Logs tab interleaves every pod, each in its own color.
- Debug adds an ephemeral container and attaches a terminal to it.
- Copy ConfigMap data, Helm values, Secret keys and applied YAML.
- Secret details show each certificate and when it expires.

Official notes: https://github.com/freelensapp/freelens/releases/tag/v2.1.0

## Facts and sources

- <https://opennavo.com/apps/freelens>
- <https://opennavo.com/apps/freelens/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/freelens.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/freelens>
- <https://github.com/freelensapp/freelens> · Checked 2026-11-13
