Documentation
Everything Kubius does, explained. Connect a cluster, browse every resource type live, dig into logs and metrics, and keep your workloads lean - pick a topic to get started.
Getting started
Getting started Kubius reads your kubeconfig from ~/.kube/config on launch. Every context defined there shows up in the Clusters section at the top of the left sidebar.… Signing in & licences Kubius is licensed per account. You sign in once on each Mac, and the app activates that device against a licence you own. There's no licence key to copy or… Dashboard The Dashboard is a single-page overview of the whole cluster - health, workload status, capacity, usage trends and anything that needs attention - so you… Connection problems When Kubius can't reach a cluster you'll see "Connection failed - Couldn't reach this cluster within 20 seconds…" in the sidebar (and a Couldn't connect… Adding a cluster Kubius normally discovers clusters from your kubeconfig (~/.kube/config, or whatever KUBECONFIG points at). When a cluster isn't in your kubeconfig - a… Navigation & shortcuts Kubius is designed for keyboard-first navigation. You rarely need the mouse to move between resources.
Working with resources
Pods Pods are the central resource type in Kubius - most other resources (Deployments, Services, etc.) link back to the pods they manage or target. Workloads All controller-style resources share a similar detail layout: a header with status badges and action menu, an Overview tab with replica gauges and container… Networking The Services list shows type, cluster IP, external IP, ports, and age. Click a row for detail. Configuration The Configuration page has a tabbed list - ConfigMaps and Secrets. The System Objects toggle filters by namespace: when it's off, ConfigMaps and Secrets… Storage & RBAC The PVC list shows status (Bound / Pending / Lost), capacity, storage class, and access modes. Detail view shows the bound PV (if any), the requested…
Observability
Logs Kubius's log viewer is built on live kubectl logs -f streams with reconnect logic, multi-pod aggregation, search, regex, and a popout floating-window mode. Terminal Open an interactive shell into any running container without leaving Kubius. Port forwarding Kubius implements port-forwarding natively (no kubectl subprocess) - every session runs inside the app, with live connection-count tracking and a floating… Metrics & usage When your cluster has metrics-server (every managed cluster does), Kubius polls every 15 seconds and shows live CPU and memory usage with history charts. Display units Kubius lets you choose how CPU and memory values are displayed in resource-usage charts, container request / limit cells, and node tables. Open Settings ▸…
Optimisation & nodes
Right-sizing Right-Sizing measures what your workloads actually consume and recommends Kubernetes resources.requests and resources.limits values that fit the observed… Sharing right-sizing By default, every right-sizing result is saved only on your Mac. Kubius Pro Cost & FinOps The Cost & FinOps view (a Kubius Pro feature) estimates what your workloads cost each month, broken down by namespace, with right-sizing savings. Open it… RBAC explorer The RBAC Explorer (a Kubius Pro feature) makes Kubernetes access control legible without reading YAML. It resolves effective permissions from the cluster's… Network policy sim The Network Policy Simulator (a Kubius Pro feature) answers "can pod A reach pod B?" by evaluating the cluster's NetworkPolicies - so you can check… Node OOM How to find why a node ran out of memory and which workload is responsible. Drain & delete nodes Sometimes you need to retire a node - a failing instance, an autoscaler quirk that left a node stuck, a manual decommission. Other times you just want to…
Power tools
Apply YAML Apply YAML (a Kubius Pro feature) lets you create or update Kubernetes objects from a manifest - paste it or load a file, validate it against the cluster,… Dependency graph Almost every resource detail view has a Graph tab showing how it connects to other resources in the cluster - upstream traffic sources, owners, dependents,… YAML viewer Every resource detail view has a YAML tab that loads the live manifest from the cluster. ArgoCD When a cluster has ArgoCD installed (CRDs in the argoproj.io group), Kubius detects it and surfaces an ArgoCD section in the sidebar with three resource… Pinned resources Pin any resource to the sidebar for one-click access - useful for the pods or deployments you check most often. Multiple windows Kubius lets you open more than one main window, each connected to its own
Settings & help
Preferences Open with ⌘, or from the menu bar. Updating Kubius Kubius keeps itself up to date with a light, optional mechanism - it never Upgrading to Pro Kubius comes in two editions. Standard covers everyday cluster work - browsing every resource type with live updates, single-pod logs, dependency graphs,… Teams & seats If you're rolling Kubius out to a team, you can buy a pool of seats and assign each one to a teammate. Everyone signs in with their own account and gets… Refer a friend Like Kubius? Share it. Every Kubius account has its own referral link - when someone new buys their first licence through it, they get a discount and you… Troubleshooting The kubeconfig context is reachable in name only. Common causes: