The architecture of Neki
Sep 18, 2026Harshit Gangal

Summary
This post provides a deep dive into the architecture of Neki, PlanetScale's sharded Postgres system. It details the roles and interactions of key components: PostgresManager for managing Postgres instances, Sidecar for connection pooling and health reporting, Shards for data partitioning with authoritative OID management, Admin for high availability and durability policy enforcement, Operator for Kubernetes lifecycle management, Router for client interaction and distributed query execution, and Replicator for data movement. It also explains the use of etcd for the Data Topology.