> Full SurrealDB documentation index: https://surrealdb.com/docs/llms.txt

# Getting started

The official documentation for SurrealDB, a multi-model database. Built for modern applications.

SurrealDB stores relational, document, graph, time-series, vector and full-text data in one engine, queried through SurrealQL and reachable from ten official SDKs. It runs embedded in your application, as a single node, or as a distributed cluster.

<AgentBanner />

## Where do you want to start?

- [I am new here](/docs/running/overview.md) - Install SurrealDB, run it locally or in the cloud, and write your first query.

- [I want to build something](/docs/learn.md) - Connect an SDK, model your data, secure it, and put it into production.

- [I need the details](/docs/reference.md) - Every SurrealQL statement, protocol message and SDK method.

## Your first query

SurrealQL is SQL-shaped, so most of it reads as you would expect. What it adds is the ability to relate records directly and traverse those relations in the same statement, without a join table or a second database. Edit and run this:

```surql
-- Records are addressed by table and id
CREATE person:alice SET name = 'Alice';
CREATE company:acme SET name = 'Acme';
-- RELATE creates a graph edge, which can carry its own fields
RELATE person:alice->works_at->company:acme SET since = d'2024-01-15';
-- Traverse the edge from the record, in the projection
SELECT name, ->works_at->company.name AS employers FROM person;
```

The [querying guide](/docs/learn/querying.md) covers the language properly, and [data models](/docs/learn/data-models.md) covers what else the engine stores.

## Connect from your language

Each SDK has a quickstart that gets you connected, and a reference covering every method.

- [Rust](/docs/languages/rust.md)

- [JavaScript](/docs/languages/javascript.md)

- [Python](/docs/languages/python.md)

- [Go](/docs/languages/golang.md)

- [.NET](/docs/languages/dotnet.md)

- [Java](/docs/languages/java.md)

- [Kotlin](/docs/languages/kotlin.md)

- [PHP](/docs/languages/php.md)

- [Swift](/docs/languages/swift.md)

- [Mojo](/docs/languages/mojo.md)

[Community SDKs](/docs/languages/community.md) cover further languages, and the [Expo](/docs/frameworks/expo.md) and [React Native](/docs/frameworks/react-native.md) guides cover mobile.

## Run it somewhere

- [SurrealDB Cloud](/docs/manage/instances.md) - A managed instance with scaling, backups and monitoring handled for you.

- [Self-hosted](/docs/manage/self-hosted.md) - Run and operate SurrealDB on your own infrastructure.

- [Docker](/docs/running/docker.md) - A container for local development and consistent environments.

- [Embedded](/docs/build/embedding.md) - The engine in-process, natively or through WebAssembly.

## The rest of the documentation

- [Learn](/docs/learn.md) - Querying, schema, data models and security.

- [Build](/docs/build.md) - Embedding, migrating, integrations and AI agents.

- [Manage](/docs/manage.md) - Instances, organisations, observability and self-hosting.

- [Explore](/docs/explore.md) - SurrealDB Studio, tutorials, demos and labs.

- [Reference](/docs/reference.md) - SurrealQL, protocols, CLI tools and SDK methods.

- [Agent Memory](/docs/agent-memory.md) - The memory and knowledge layer for AI agents.