Embedded and edge

Q: What platforms does SurrealDB support for embedded/edge?

SurrealDB runs on Linux, macOS, Windows, and in the browser via WebAssembly. The Rust SDK provides embedded mode for in-process usage. The JavaScript SDK includes a WASM engine for browser deployment.

Q: Can I use the same queries on edge and cloud?

Yes. SurrealDB uses the same query language (SurrealQL), the same data model, and the same API regardless of deployment mode. Code written for an embedded instance works identically on a cloud cluster.

Run SurrealDB on edge devices, in browsers with WASM, or embedded in your application binary. Single binary, offline-ready, and the same API from edge to cloud.

SINGLE BINARY

One binary, any device

SurrealDB ships as a single binary with zero external dependencies. Embed it in your application, run it on a Raspberry Pi, or deploy it in a container. The same API, the same query language, the same data model - everywhere.

Embedded mode

Import SurrealDB as a library and run it in-process. Zero network hops, zero latency overhead, zero separate services to manage.

WASM runtime

Run SurrealDB in the browser with WebAssembly. Full query engine, offline-capable, with the same SurrealQL you use server-side.

Edge devices

Deploy on IoT devices, mobile applications, and edge nodes. Collect, process, and serve data where it is generated.

EDGE SYNC

Offline-first, sync when connected

Edge instances operate independently when disconnected and synchronise when connectivity returns. The same API from prototype to production - from in-memory local development to fully managed cloud.

Offline-first

Applications continue working without connectivity. Reads and writes happen locally with full ACID guarantees.

Sync on connect

When connectivity returns, edge instances synchronise with the central database. Conflict resolution is built in.

Same API everywhere

The same SurrealQL, the same SDKs, the same data model from a WASM browser instance to a cloud cluster.

Scale from edge to cloud

Start embedded, grow to single-node, scale to distributed cluster - without rewriting application code.

AI AT THE EDGE

Agent context at the edge

SurrealDB's single binary and WASM runtime mean the context layer can run on edge devices. Agents reason over locally stored context with full multi-model queries, synchronise memory when connectivity returns, and scale from an embedded WASM agent to a cloud-scale distributed cluster - no code changes.

FREQUENTLY ASKED QUESTIONS

Embedded and edge

What platforms does SurrealDB support for embedded/edge?

Can I use the same queries on edge and cloud?

GET STARTED

Run SurrealDB at the edge

Single binary, WASM, edge sync - the same API from embedded to cloud.

SOC 2 Type 2

GDPR

Cyber Essentials Plus

ISO 27001