# SurrealDB on Layerbase Desktop and CLI

> Run SurrealDB locally with Layerbase Desktop or self-host it with the Layerbase CLI. Multi-model database, SurrealQL, embedded or networked.

Canonical: https://layerbase.com/db/surrealdb
Last updated: 2026-08-25

Multi-model database (documents, graphs, relations, key-value) with SurrealQL. Available on Layerbase Desktop and self-hosted with the Layerbase CLI.

## Key facts

| Fact | Value |
| --- | --- |
| Engine | SurrealDB |
| Category | Multi-Model |
| Upstream project | [SurrealDB](https://surrealdb.com/) |
| Layerbase Cloud | No |
| Layerbase Desktop | Yes |
| SpinDB (local CLI) | Yes |
| Best for | Prototypes that mix document, graph, and relational data, schema-flexible apps, and developers exploring SurrealQL as a single-language data layer. |

## Availability on Layerbase Cloud

The Business Source License wording makes us uncomfortable to host SurrealDB as a serverless platform. We would rather skip Cloud entirely than ship something where the redistribution and managed-host terms are unclear.

If you're with SurrealDB and would like to work with us on a managed offering, we would love to hear from you.

## Use cases

- Prototype an app that wants document and graph queries from the same engine
- Build a single-process backend with SurrealDB embedded, then move to networked mode
- Develop against SurrealDB on the desktop with the same UI as your other databases
- Self-host SurrealDB on your own infra with the Layerbase CLI
- Explore SurrealQL syntax before committing to a multi-model architecture

## Common SurrealDB questions

### What is SurrealDB?

SurrealDB is a multi-model database that handles document, graph, relational, and key-value data through a single query language, SurrealQL. It can run embedded inside a process or as a networked server, which makes it a common pick for prototypes that mix data shapes. Layerbase does not host it on Cloud for licensing reasons, but it runs on Layerbase Desktop and self-hosted through the Layerbase CLI, in both cases as the upstream binary.

### How much does SurrealDB cost on Layerbase?

There is no managed SurrealDB to buy: it is not on Layerbase Cloud for licensing reasons, so no plan includes it. Layerbase Desktop is free for personal use and runs the upstream binary on your own machine, and self-hosting it with the Layerbase CLI costs whatever your own hardware costs.

### Why is SurrealDB not on Layerbase Cloud?

SurrealDB ships under the Business Source License (BSL), which restricts hosted commercial offerings. On the desktop or via the Layerbase CLI you run the upstream binary under its standard license.

### Which SurrealDB version does Layerbase run?

Desktop and the Layerbase CLI track recent stable SurrealDB releases. The version is shown in the dashboard.

### Can I run SurrealDB embedded or networked on Layerbase?

Both modes work. The dashboard surfaces a networked endpoint by default; embedded use is supported through the SDK against the same data file.

### When would Layerbase Cloud add SurrealDB?

When the licensing situation allows or via a direct partnership. For now, desktop and self-host are the supported paths.

### Can SurrealDB replace my Postgres?

Sometimes. SurrealQL is expressive and the multi-model fit is nice for prototypes. For high-throughput transactional workloads, mature Postgres tooling is still the safer choice.

## Links

- [SurrealDB on Layerbase](https://layerbase.com/db/surrealdb)
- [Pricing](https://layerbase.com/pricing) (markdown: https://layerbase.com/pricing.md)
