Skip to main content

Sukko Docs

Multi-tenant WebSocket infrastructure. Deploy in your own cloud, connect your Kafka pipeline, deliver real-time data to thousands of clients with sub-millisecond fan-out.

Get Started in 5 MinutesHow It Works

Deploy in Your Cloud (BYOC)

Run Sukko in your own Kubernetes cluster — DOKS, GKE, EKS, or any conformant K8s. Your data never leaves your infrastructure. Helm charts and CLI tooling included.

Multi-Tenant from Day One

Tenant isolation at every layer — connections, channels, Kafka topics, and database queries. Per-tenant JWT keys, channel rules, quotas, and connection limits. Not bolted on, built in.

Pluggable Backends

Swap the message backend (direct, Kafka/Redpanda) and broadcast bus (Valkey) independently. Start simple with direct mode, move to Kafka for production — no code changes.

Kafka-Native Ingestion

Publish to Kafka/Redpanda, Sukko delivers to WebSocket clients. Per-tenant topic routing, shared or dedicated consumers, three-layer backpressure protection.

Sub-Millisecond Fan-Out

Sharded connection architecture with broadcast bus for inter-pod distribution. Subscription index eliminates O(N) scans — direct lookup of subscribers per channel.

Channel Access Control

Public, user-scoped, and group-scoped channels enforced at the gateway via JWT claims. Per-tenant channel rules configurable through the provisioning API.

Built-In Test Suite

Integrated tester service with smoke, load, stress, soak, and 9 validation suites. Orchestrated via the CLI — test locally or against remote deployments with context switching.

Multiple Transports

WebSocket, Server-Sent Events (SSE), and push notifications (FCM for Android, APNs for iOS/macOS, Web Push for browsers). Same tenant isolation and channel rules across all transports.

Framework SDKs

TypeScript SDK with first-class React, Vue, and Svelte bindings — token refresh, connection state, and subscriptions handled for you. More languages coming soon.

Observability

Pre-built Grafana dashboards for connections, throughput, and per-tenant metrics. Prometheus metrics out of the box, structured log search via Loki.

Developer CLI

Full-featured CLI for managing tenants, keys, rules, and deployments. Local dev with sukko init/up, context switching for remote environments, and integrated test orchestration.