SurrealDB
SurrealDB is a modern "all-in-one" database that stores and organises your app's information.
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
Security check: 2 serious findings
- A private key is committed in the source code (surrealdb/core/src/iam/signin.rs:1626)
- A private key is committed in the source code (surrealdb/core/src/iam/signup.rs:671)
Automated checks on commit 18971ff, 12 Oct 2026. Not an audit.
- 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
Variants
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
- How are people deploying surrealdb? : r/surrealdb - Reddit (reddit)
- surrealdb - Reddit (reddit)
- Have any of you used SurrealDB and what are your thoughts? (reddit)
- Newest 'surrealdb' Questions - Stack Overflow (forum)
Collected 48 days ago - public community threads