Docs / Getting started
Getting started
Install Klystiq, open your first clusters, and find your way around.
Klystiq is a desktop app for working with many Kubernetes clusters at once. It reads the kubeconfig you already use with kubectl, talks to your clusters directly with your own credentials, and runs entirely on your computer: there's no account, no server in the middle and nothing to install in your clusters.
Install
Download the installer for your system from the download page:
| System | File |
|---|---|
| macOS 11+, Apple silicon | .dmg (aarch64) |
| macOS 11+, Intel | .dmg (x64) |
| Windows 10 or 11 (x64) | -setup.exe (per-user) or .msi |
| Debian, Ubuntu 22.04+ | .deb: sudo apt install ./Klystiq_<version>_amd64.deb |
| Fedora, RHEL, openSUSE | .rpm: sudo dnf install ./Klystiq-<version>-1.x86_64.rpm |
| Any Linux | .AppImage: chmod +x it, then run it |
Builds aren't code-signed yet. On macOS, open the app the first time with right-click → Open. On Windows, SmartScreen asks you to confirm: More info → Run anyway. You can check any download against the SHA256SUMS file on the download page.
Connect your clusters
Klystiq reads your kubeconfig from KUBECONFIG, or ~/.kube/config if that's unset, and never changes it.
Credential plugins such as aws, gke-gcloud-auth-plugin and kubelogin must be on your shell's PATH, just as they are for kubectl. Klystiq runs them the same way kubectl does.
No kubeconfig yet?
On the Contexts page, Add from cloud… lists the clusters you can reach with your own cloud CLI:
- Amazon EKS: the clusters of an AWS profile, in the regions you name (signs in with
aws eks get-token). - Google GKE: the clusters of a Google Cloud project (signs in with
gke-gcloud-auth-plugin). - Azure AKS: the clusters of an Azure subscription (
az aks get-credentials, withkubelogin -l azureclifor Microsoft Entra ID clusters).
The ones you pick are written to cloud-kubeconfig.yaml in Klystiq's settings folder, which it reads after your own files. Clusters you already have a context for are left alone.
Open contexts
Open one or more contexts on the Contexts page. From then on, every resource list merges all open contexts: the Pods page shows Pods from every cluster you opened, with a Context column so you always know which is which.
- Enter or double-click opens a resource in the current tab; Cmd/Ctrl+Enter or middle-click opens it in a new tab.
- Cmd/Ctrl+K searches resources by name across every open cluster, and jumps to pages, contexts and workspaces.
- ? shows every keyboard shortcut. See Navigating for the full list.
Open tabs, the active tab and the namespace filter come back the next time you launch Klystiq.
Make production read-only
In a context's settings you can mark it read-only. Klystiq then refuses every write to that cluster, in its Rust backend as well as in the interface: applies, scaling, restarts, deletes, shells, GitOps actions and agent proposals. Reading, logs, comparisons and permission checks still work. It's the simplest way to look at production without worrying about a slip of the keyboard. See Working with resources.
Personal use and licenses
Klystiq is free for personal use, with every feature. Using it for work needs a Pro or Business license after a short evaluation; see Licenses.