Multi-Cluster Management

Kunobi supports connecting to multiple Kubernetes clusters at the same time. This lets you monitor, compare, and operate across clusters without disconnecting from one to access another.

Connecting Multiple Clusters

There is no limit to the number of clusters you can connect to simultaneously.

1. Navigate to the Clusters page
2. Click Connect on each cluster you want to work with
3. Each cluster shows its own status indicator, latency, and Kubernetes version

Switching the Active Cluster

The cluster selector lives in the bottom bar of the application. Click on the currently active cluster name at the bottom left to open the selector dialog.

The dialog shows all available clusters with their connection status. Connected clusters show a Disconnect button; others show Connect. Favorites appear at the top with a star icon and keyboard shortcuts (⌘1, ⌘2, etc.) for quick switching.

You can also search clusters by name using the search bar at the top of the dialog. The active cluster context is persisted per-tab if you're using tab navigation.

Favorite Clusters

Mark clusters you use frequently with the star icon on the Clusters page. Favorites:

• Float to the top of the clusters list
• Are prioritized by the Auto-Select Cluster setting when you launch Kunobi

Auto-Select Cluster

When enabled, Kunobi automatically selects a cluster when you launch the app (or when you connect to a cluster), so you can go straight to exploring resources.

Configure this in Settings → General → Auto-Select Cluster. See General Settings for details.

Auto-Reconnect

If a cluster connection drops (e.g., due to a network interruption), Kunobi can automatically attempt to reconnect.

Configure the retry count in Settings → General → Auto-Reconnect Retries. Set to 0 to disable auto-reconnect.

Context Switching

Kunobi reads all contexts from your kubeconfig files (including files in custom directories if you've configured Context Watcher).

The Clusters page lists every available context. Connected clusters show their live status; disconnected ones can be connected with a single click.

Multiple Kubeconfig Files

If you manage multiple kubeconfig files (e.g., one per environment), configure the Context Watcher to point to the directory containing them. Kunobi will merge all contexts into a single list.

See Context Watcher for configuration details.

Tab Navigation

Kunobi supports browser-like tabs in the top bar. Each tab is independent and can show a different page (K8s Resources, Clusters, etc.).

• Open a new tab — Click + or press ⌘T
• Close a tab — Click the × on the tab
• Switch tabs — Click any tab in the top bar

Troubleshooting

Connection Errors

If a cluster shows an Error status, click on it to open the details sidebar and view the error message. Common causes:

• VPN not connected
• Cluster API server unreachable
• Expired or revoked kubeconfig credentials
• Certificate errors

See the Clusters page for full troubleshooting steps.

Stale Contexts

If you've added or removed clusters from your kubeconfig but they don't appear in Kunobi, the Context Watcher will automatically reload the list. You can also trigger a manual reload by navigating away from and back to the Clusters page.