SurrealDB

SurrealDB is a modern "all-in-one" database that stores and organises your app's information.

  • Databases
  • Development
SurrealDB is a modern "all-in-one" database that stores and organises your app's information. It simplifies development by combining several complex tools into one package, allowing creators to build fast, collaborative apps more easily without needing a massive technical infrastructure.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

71/100 Good

Maintained
100last commit 18 days ago
Popular
9033,286 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
95512 MB minimum RAM, runs on ARM
Security check
152 serious findings, 4 minor, CI, tests, OpenSSF Scorecard 5.9/10
GitHub stars
33,286
Open issues
432
Last commit
2026-11-03
Latest release
v4.0.0
Activity
rising

Checked 15 days ago - source: GitHub (surrealdb/surrealdb)

Resources & Compatibility

Minimum requirements: 512 MB RAM. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Use stable for the first install In a terminal, run the stable installer command without the --beta or --nightly flags, and on macOS you can use Homebrew with `brew install surrealdb/tap/surreal`. That gets you the normal release and a quick way to find the surreal command, while beta and nightly can have unfinished features or unexpected changes. source
  • Check that it is actually running After starting SurrealDB as a service, check its status and look for “Active: active (running)”; if it is not, the database is not up and clients cannot connect. The status also shows the start command, including login settings, so you can spot wrong credentials before sharing the service. source
  • Use Docker help to find settings If you are using Docker, run `docker run --rm surrealdb/surrealdb:latest start --help` before creating your own container. It lists the environment variables you can set, so you know what options are available instead of guessing. source

Fetched 53 days ago - each note links to its source

Alternatives (8)

  • Directus - An Instant App & API for your SQL Database.
  • Firebase - Firebase, provided by Google, is a backend service and application development platform.
  • MongoDB - MongoDB is an open-source, document-oriented NoSQL database that stores flexible, JSON-like documents, helping developers and self-hosters…
  • Neon Postgres - The fully managed serverless Postgres with a generous free tier.
  • PocketBase - PocketBase is an open-source backend in a single file that bundles an embedded SQLite database with realtime subscriptions, built-in file a…
  • PostgreSQL - PostgreSQL (Postgres) is an open source object-relational database known for reliability and data integrity.
  • Supabase - The open source Firebase alternative.
  • neo4j - Neo4j is a graph database for developers to store, query, and traverse interconnected data as nodes and relationships in high-performance a…

Checked 54 days ago - source: AlternativeTo

Common questions

How can I find the environment variables to set before creating a custom SurrealDB Docker container?

Run the image's start command with help before creating your own container. It lists the environment variables you can set, so you can choose options instead of guessing.

How do I verify a Linux SurrealDB service is running and using the intended login settings?

Check the service status to confirm it is active and running; if it is not, the database is not up and clients cannot connect. The status also shows the start command, including login settings, so you can spot wrong credentials.

Should I use stable, beta, or nightly SurrealDB for a first self-hosted installation?

Use stable for the first install by running the installer without the beta or nightly flags, and on macOS use Homebrew with the SurrealDB tap. Beta and nightly can have unfinished features or unexpected changes.

What storage engine and process model do most self-hosted SurrealDB workloads use?

Most self-hosted workloads use RocksDB on disk. They run one SurrealDB process per database file.

Do I need a separate engine for SurrealDB Agent Memory?

SurrealDB and Agent Memory run on the same engine, so Agent Memory is built on top of the database rather than a separate engine.

Answers sourced from github.com, github.com, github.com, surrealdb.com, surrealdb.com

Community

Collected 48 days ago - public community threads