Skip to main content

Getting Started

Install​

Download the latest release for your platform from the releases page.

PlatformBinary
Linux x86_64KubezillaDesktop (AppImage or extracted binary)
macOS Intel / Apple SiliconKubezillaDesktop.app
Windows x86_64KubezillaDesktop.exe

Optional: PVC/Pod mount support​

To mount PVCs or pod filesystems as local drives:

  • Linux — install the fuse3 runtime package via your distro's package manager (Debian/Ubuntu: sudo apt-get install -y fuse3; Fedora/RHEL: sudo dnf install fuse3; Arch: sudo pacman -S fuse3). Add yourself to the fuse group and re-login.
  • macOS — install macFUSE, reboot, allow the kernel extension in System Settings → Privacy & Security.
  • Windows — install WinFsp (select the "Core" component).

Browsing PVCs and pod filesystems works on all platforms without these — only local mounting requires them.

First launch​

On start, Kubezilla:

  1. Auto-discovers kubeconfig files in ~/.kube/ (not on sandboxed macOS builds — see Connecting to Clusters).
  2. Loads the first kubeconfig + context pair it finds.
  3. Lists namespaces and API resources.
  4. Shows the default resource kind (Pods) for the selected namespace.

If no kubeconfig is found, the app still launches — open the Kubeconfigs dialog from the Dots menu to add one manually.

The main window​

  • Toolbar (top) — kubeconfig / context / namespace / kind / search.
  • View-mode toggle — switch between Table and Graph view.
  • Dots menu (⋯) — Helm Install, Create Resource, Columns, New Window, Themes, Settings.
  • Resource table — the current view; right-click any row for actions.

Minimum viable workflow​

  1. Pick a kubeconfig and context.
  2. Pick a namespace (or All namespaces).
  3. Open the Kind selector with Cmd/Ctrl + K and pick the resource kind.
  4. Double-click a row to open its Info window, or right-click for a context menu.

From there, see: