Welcome

Welcome to Octokube! This guide will help you connect your first Kubernetes cluster and invite your team in just a few minutes.

Octokube is a multi-tenant Kubernetes management platform built for infrastructure teams. It gives every engineer a full Kubernetes IDE in the browser — with zero-trust access, virtual RBAC, and real-time visibility — without a single kubeconfig on developer machines.

Think of it as Lens, but for your entire team, running in the browser, with granular access control that goes beyond what Kubernetes natively supports.


Core concepts

Before diving in, there are four concepts that define how Octokube works:

Agent A lightweight component you deploy once inside your cluster. The Agent is the only piece with direct access to the kube-apiserver. No developer ever connects to your cluster directly — all requests are brokered through the Agent.

Virtual RBAC A permission layer on top of native Kubernetes RBAC. Lets you define access rules by user, team, namespace, resource type, and time window — without modifying cluster-level roles or redeploying anything.

Real-time multiplexing A single persistent connection from the Agent delivers live cluster state to every connected team member simultaneously. Individual Virtual RBAC rules are applied per user before any data is delivered.

Web IDE The browser-based interface where your team manages workloads, inspects resources, and monitors cluster state. No local setup, no kubectl, no VPN required.


How it works

  1. Deploy the Agent into your cluster using a single manifest or Helm chart
  2. Invite your team and assign Virtual RBAC roles to each member
  3. Everyone connects through the Octokube dashboard — each person sees exactly what they have permission to see, in real time

What you will find in these docs

  • Getting Started — connect your first cluster and invite your team
  • Virtual RBAC — define roles, rules, and time-based access policies
  • Platform — Web IDE, workload explorer, and observability features
  • Security — how the Agent works and what zero-trust means in practice
  • API Reference — programmatic access to Octokube resources

Not sure where to start?

If this is your first time, go to Quickstart and have your cluster connected in under 5 minutes.

On this page