How to install

Installation guide View features

Cloud. Fully managed, from a free tier.

Binary. One surreal binary, the same engine everywhere.

Latest. SurrealDB

v3.3.0

01 |INSTALL THE CLI

Choose your platform. One command installs the CLI and the server as a single executable.

macOS

Install on macOS

The quickest way to get going on macOS is Homebrew, which installs the command-line tools and the SurrealDB server as a single executable. Without Homebrew, follow the Linux instructions instead.

brew install surrealdb/tap/surreal

Linux

Install on Linux

The preferred way to get going on Unix systems is the SurrealDB install script. Run the following in your terminal and follow the on-screen instructions.

curl -sSf https://install.surrealdb.com | sh

Windows

Install on Windows

On Windows, install the SurrealDB command-line tool with PowerShell, or use the Chocolatey or Scoop package managers from an administrative shell for easy installation and upgrades.

iwr https://windows.surrealdb.com -useb | iex

choco install surreal

scoop install surrealdb

Docker

Install on Docker

Docker lets you run SurrealDB without installing any CLI tools locally. The container includes the full CLI for import/export and for running a server.

docker run --rm --pull always -p 8000:8000 surrealdb/surrealdb:latest start

02 |VERIFY AND RUN

Confirm the install, then start. Check the CLI is on your path and bring up a local server.

Version

Check the version

Confirms the CLI is on your path and which release it is.

surreal version

Start

Start a local server

An in-memory instance on port 8000, with a root user for the session.

surreal start --user root --pass root memory

Persist

Persist to disk

The same server with its data kept in a SurrealKV directory.

surreal start --user root --pass root surrealkv://data

Shell

Open a SQL shell

An interactive SurrealQL prompt against the running server.

surreal sql --endpoint http://localhost:8000 --user root --pass root --ns test --db test

THE PLATFORM

Everything an application and its agents know. Five surfaces, one engine.

Database

Document, graph, vector, time-series and relational in one engine.

Five data models as dotted tiles: documents, graph, vector, time-series and relational

Agent Memory

What an agent learns, with its source and its time, in the same engine.

A timeline of remembered facts, each with its source

Cloud

Managed clusters in the regions you choose, scaled on demand.

Clusters in three regions on a world map, each running or scaling

Studio

Query, explore and design the schema from the browser.

MCP

Every model that speaks MCP reaches the database and the memory directly.

Three models connected through MCP to the database and Agent Memory

IN PRODUCTION

Trusted at scale. Samsung, Nvidia, Verizon, Tencent and Walmart run on SurrealDB.

14,000+

Developers building on SurrealDB Cloud

4M+

Developers building on SurrealDB worldwide

FROM THE TEAMS

SurrealDB gives us a foundation where we can unify semantic search, knowledge graphs, and AI-driven decision making without stitching together multiple systems. Collapsing responsibility into SurrealDB has become our default engineering posture.

Justin Foley

VP of Engineering, Later

GET STARTED

Start building with SurrealDB. Read the docs, try it in the cloud, or start building.

Start free with SurrealDB View documentation