Installation

May 8, 2026 · View on GitHub

lfk is distributed as a single static Go binary. Pick whichever method fits your platform.

Homebrew (macOS / Linux)

brew install janosmiko/tap/lfk

Linux

AUR (Arch, Manjaro, EndeavourOS)

yay -S lfk-bin
# or
paru -S lfk-bin
# or, manually:
git clone https://aur.archlinux.org/lfk-bin.git && cd lfk-bin && makepkg -si

The lfk-bin package installs the prebuilt binary from the GitHub release. There is no source-build (lfk AUR) package; if you want to build from source, use go install github.com/janosmiko/lfk@latest.

Debian / Ubuntu (Cloudsmith APT)

Add the Cloudsmith repository, then install:

curl -1sLf 'https://dl.cloudsmith.io/public/janosmiko/lfk/setup.deb.sh' | sudo -E bash
sudo apt update
sudo apt install lfk

The setup script imports the Cloudsmith GPG key and writes /etc/apt/sources.list.d/janosmiko-lfk.list. Manual setup steps are also documented at https://cloudsmith.io/~janosmiko/repos/lfk/setup/#formats-deb.

Fedora / RHEL / CentOS (Cloudsmith DNF)

Add the Cloudsmith repository, then install:

curl -1sLf 'https://dl.cloudsmith.io/public/janosmiko/lfk/setup.rpm.sh' | sudo -E bash
sudo dnf install lfk

Manual setup steps are documented at https://cloudsmith.io/~janosmiko/repos/lfk/setup/#formats-rpm.

Nix (flake)

Requires Nix ≥ 2.4 with flakes enabled (experimental-features = nix-command flakes in ~/.config/nix/nix.conf).

Try without installing:

nix run github:janosmiko/lfk
# pinned to a release:
nix run github:janosmiko/lfk/v0.9.22

Install into your profile:

nix profile install github:janosmiko/lfk
# or a specific release:
nix profile install github:janosmiko/lfk/v0.9.22

Use as a flake input (e.g. in a NixOS / home-manager config):

{
  inputs.lfk.url = "github:janosmiko/lfk";

  outputs = { self, nixpkgs, lfk, ... }: {
    # ...
    environment.systemPackages = [ lfk.packages.${system}.default ];
  };
}

Binary releases

Download pre-built binaries from the GitHub Releases page.

Windows

Scoop

scoop bucket add janosmiko https://github.com/janosmiko/scoop-bucket
scoop install lfk

Winget

winget install janosmiko.lfk

The first release after a tag opens an automatic PR to microsoft/winget-pkgs. The package becomes installable once that PR is merged by the Winget maintainers.

Chocolatey

choco install lfk

First-time installs from Chocolatey show "Pending" until chocolatey.org moderation completes. Subsequent versions are available immediately after publish.

Manual binary

Download lfk_<version>_windows_<arch>.zip from GitHub Releases, extract lfk.exe into a directory in your PATH, and verify with lfk --version. Each archive is covered by the same cosign Sigstore bundle as Linux/macOS builds.

From source

Using go install (fetches via the Go module proxy):

go install github.com/janosmiko/lfk@latest

From a local clone:

git clone https://github.com/janosmiko/lfk.git
cd lfk
go build -o lfk .

Docker

docker run -it --rm \
  -v ~/.kube:/home/lfk/.kube:ro \
  janosmiko/lfk

To use a specific kubeconfig:

docker run -it --rm \
  -v /path/to/kubeconfig:/home/lfk/.kube/config:ro \
  janosmiko/lfk

For port forwarding, add --net=host:

docker run -it --rm \
  --net=host \
  -v ~/.kube:/home/lfk/.kube:ro \
  janosmiko/lfk

External Dependencies

Required:

  • kubectl - Kubernetes CLI (must be configured and in PATH)

Optional (needed only for specific features):

CommandFeature
helmHelm release management (values, diff, upgrade, rollback, uninstall)
trivyContainer image vulnerability scanning (install)

All other features (KEDA, External Secrets, Argo Workflows, cert-manager, ArgoCD, FluxCD, PVC resize, etc.) use the Kubernetes API directly and require no additional CLI tools.