@freelensapp/fluxcd-extension

This extension integrates FluxCD support into Freelens. FluxCD v2.0.0 or higher is supported.

Features include:

• Comprehensive dashboard for FluxCD Application components and Events.
• Resource menus for reconciling, syncing, and automating FluxCD resources.
• Detailed views of FluxCD resource information.

Screenshots

Dashboard

Install

To install or upgrade: open Freelens and go to Extensions (ctrl+shift+E or cmd+shift+E), and install @freelensapp/fluxcd-extension.

or:

Use a following URL in the browser: freelens://app/extensions/install/%40freelensapp%2Ffluxcd-extension

Migrating from @freelensapp/extension-fluxcd

The package was renamed from @freelensapp/extension-fluxcd to @freelensapp/fluxcd-extension starting with v4.0.0.

If you have the old package installed, you will not receive updates and may encounter issues with newer Flux versions (e.g., Flux 2.7+ which removed v1beta1 APIs).

To migrate:

1. Open Freelens Extensions (ctrl+shift+E or cmd+shift+E)
2. Uninstall @freelensapp/extension-fluxcd (the old package)
3. Install @freelensapp/fluxcd-extension (the new package)

Requirements

• Kubernetes >= 1.24
• Freelens >= 1.6.0
• Flux >= v2.0.0, <= 2.7.x
• flux-operator >= v0.6.0
• kustomize-controller >= v0.1.0
• helm-controller >= v0.1.0
• image-automation-controller >= v0.14.0
• image-reflector-controller >= v0.11.0
• notification-controller >= v0.1.0
• source-controller >= v0.1.0

API supported

• fluxcd.controlplane.io/v1
• helm.toolkit.fluxcd.io/v2beta1 (helm-controller)
• helm.toolkit.fluxcd.io/v2beta2 (helm-controller)
• helm.toolkit.fluxcd.io/v2 (helm-controller)
• kustomize.toolkit.fluxcd.io/v1beta1 (kustomize-controller)
• kustomize.toolkit.fluxcd.io/v1beta2 (kustomize-controller)
• kustomize.toolkit.fluxcd.io/v1 (kustomize-controller)
• image.toolkit.fluxcd.io/v1beta1 (image-automation-controller)
• image.toolkit.fluxcd.io/v1beta2 (image-automation-controller)
• image.toolkit.fluxcd.io/v1 (image-automation-controller)
• image.toolkit.fluxcd.io/v1beta1 (image-reflector-controller)
• image.toolkit.fluxcd.io/v1beta2 (image-reflector-controller)
• image.toolkit.fluxcd.io/v1 (image-reflector-controller)
• notification.toolkit.fluxcd.io/v1beta1 (notification-controller)
• notification.toolkit.fluxcd.io/v1beta2 (notification-controller)
• notification.toolkit.fluxcd.io/v1beta3 (notification-controller)
• notification.toolkit.fluxcd.io/v1 (notification-controller)
• source.toolkit.fluxcd.io/v1beta1 (source-controller)
• source.toolkit.fluxcd.io/v1beta2 (source-controller)
• source.toolkit.fluxcd.io/v1 (source-controller)

Build from the source

You can build the extension using this repository.

Prerequisites

Use NVM or mise-en-place or windows-nvm to install the required Node.js version.

From the root of this repository:

nvm install
# or
mise install
# or
winget install CoreyButler.NVMforWindows
nvm install 22.16.0
nvm use 22.16.0

Install Pnpm:

corepack install
# or
curl -fsSL https://get.pnpm.io/install.sh | sh -
# or
winget install pnpm.pnpm

Build extension

pnpm i
pnpm build
pnpm pack

Install built extension

The tarball for the extension will be placed in the current directory. In Freelens, navigate to the Extensions list and provide the path to the tarball to be loaded, or drag and drop the extension tarball into the Freelens window. After loading for a moment, the extension should appear in the list of enabled extensions.

License

Copyright (c) 2025 Freelens Authors.

MIT License

Based on:

• https://github.com/appvia/lens-fluxcd-extension
• https://github.com/okaufmann/lens-fluxcd-extension