# SurrealDB

SurrealDB is a modern "all-in-one" database that stores and organises your app's information. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/5333/surrealdb

## Description

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.

## Health score

71/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 18 days ago)
- Popular: 90 (33,286 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 95 (512 MB minimum RAM, runs on ARM)
- Security check: 15 (2 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; A private key is committed in the source code.
Automated checks on commit 18971ff, 12 Oct 2026. Not an audit.

## Links

- Official website: https://surrealdb.com/
- Documentation: https://surrealdb.com/docs/surrealdb
- Docker Hub: https://hub.docker.com/r/surrealdb/surrealdb
- Unraid: https://ca.unraid.net/apps?q=surrealdb&app=lrjl3m
- GitHub: https://github.com/surrealdb/surrealdb

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/5333/surrealdb), the self-hosted and open-source app directory.
