FAQ¶
Is Kubus free?¶
Yes — free and open source under the MIT license.
Does my cluster data leave my machine?¶
No. The server runs locally, binds to 127.0.0.1, and talks to your clusters with your
own kubeconfig. There's no Kubus cloud and no telemetry. See the
security model.
Do I need to install anything in my cluster?¶
No. Kubus works against any cluster your kubeconfig can reach. A couple of features are nicer with add-ons — metrics-server for CPU/memory charts — but everything degrades gracefully without them.
Does it work with my managed cluster (EKS / GKE / AKS / k3s / …)?¶
If kubectl can talk to it, so can Kubus — it uses the same kubeconfig and credential
plugins. Getting a 401 or 403 from a cloud cluster? That's almost always the credential
plugin or the cloud login, not Kubus — see
Cloud-managed clusters.
Will it show my CustomResourceDefinitions?¶
Yes, automatically — including their printer columns. See Browsing resources.
Can it manage Helm releases without the helm binary?¶
Yes. The server decodes Helm's release secrets itself. Note that lifecycle hooks aren't executed on rollback/uninstall — see Helm releases.
How do I stop myself nuking production?¶
Mark the cluster as protected. Destructive actions then require typing the resource name. It's a UI guard, not RBAC — see Production guard.
Why does macOS say the app is damaged / unverified?¶
The builds aren't notarised yet. Right-click → Open, or run
xattr -dr com.apple.quarantine /Applications/Kubus.app. Details on the
Desktop app page.
Can I run it on a remote/headless box?¶
You can run the server from source, but it binds to
127.0.0.1 by design. Reach it over an SSH tunnel rather than exposing it — it's built to
be a local tool.
Which port does it use?¶
3001 by default; change it with --port or $PORT. See
command-line flags.
How do I update?¶
Desktop: install the newer release over the top. From source: git pull && pnpm install &&
pnpm build.
Something's missing or broken — where do I report it?¶
Open an issue on GitHub. See Contributing.