Rowkai

Rowkai Docs

Architecture guide.

Architecture

Compute and storage are separated so branching stays fast and tenant infrastructure stays legible.

Rowkai uses a Neon-style architecture with stateless computes, shared page storage, WAL ingestion, and a control plane that manages tenants, timelines, branches, and compute lifecycle.

Core services

  • Control plane for APIs and compute orchestration
  • Pageserver for versioned page reads and ancestry traversal
  • WAL service for durable WAL handling and quorum mode
  • Postgres-compatible computes using the Rowkai storage manager

Branching model

  • Instant branch creation with metadata-only writes
  • Copy-on-write page storage
  • Timeline ancestry traversal
  • Nested branches for preview, support, and rollout paths

Why it matters

This makes Rowkai one system for multitenant Postgres-compatible infrastructure, instead of a stack of custom snapshot jobs, restore scripts, and separate GraphQL glue.