• Start
Sign In

Architecture

The single-node and multi-node topologies behind the Start and Scale plans, and what each one means for growth and recovery.

This page explains the two topologies an instance can run on, and what each one means for growth and recovery.

The plan you choose when you create an instance selects the topology.

Instances build on the layered architecture of SurrealDB, which separates storage from compute. That separation lets an instance grow, replicate, and recover without you sharding or resharding the database yourself.

The Start plan provides one compute node backed by a dedicated disk. Compute and storage are sized together and resized together, and the node holds the only copy of the working data.

This topology suits development, staging, and production workloads that fit on one node and can tolerate a short recovery window. It scales vertically: as load grows, you move to a larger instance type. See Scaling.

Because there is a single node, there is no failover inside the instance. Backups are the recovery mechanism. See High availability for what that means in practice.

The Scale plan runs a cluster of three compute nodes or more over distributed storage. Each node runs in a different availability zone within the region, backed by its own disk.

Data is replicated continuously between nodes, and every node serves reads, writes, and queries. The storage layer handles replication, quorum consensus, and distributed transactions. A query therefore does not need to know which node holds which data.

The practical consequences are:

  • Node loss is survivable. A quorum of the remaining nodes keeps serving. Three nodes is the minimum, because three nodes leave a majority when one node is out for a failure, an upgrade, or maintenance.

  • Query capacity scales horizontally. Adding nodes adds throughput. Vertical scaling is bounded by the largest available instance type.

  • Self-hosting the same topology is more work. Running it yourself means operating Kubernetes, storage replication, patching, backups, and upgrade orchestration. Scale covers that work for you. Compare Self-hosted deployment models.

Note

Several Scale capabilities are still on the roadmap: object-storage backing, cross-region replication, automatic sharding, and read replicas. Object-storage backing keeps hot data on disk and cold data in object storage, which in turn enables instant database branching. See Pricing and Roadmap for current availability.

Was this page helpful?