---
title: "Self-hosted"
description: "SurrealDB deployment models on your own infrastructure. Containers, configuration, backups, monitoring, and upgrades."
canonical_url: "https://surrealdb.com/docs/operate/self-hosted"
section: "Self-hosted"
surrealdb_version: "4.x"
last_modified: "2026-11-18T02:09:16Z"
---

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

# Self-hosted

SurrealDB deployment models on your own infrastructure. Containers, configuration, backups, monitoring, and upgrades.

Running SurrealDB yourself is quick to start and gives you full control over storage, configuration, and placement. Everything needed to start a server and to import and export data is in the [command-line tool](/docs/reference/cli/db.md), packaged and distributed as a single executable that can be downloaded, installed, or run from within Docker.

For initial installation, see the [installation guide](/docs/running/installation.md). If you would rather not operate the infrastructure, see [Instances](/docs/operate/instances.md) for the managed option.

## Deployment guides

| Guide | Typical use |
| --- | --- |
| [Deployment models](/docs/operate/self-hosted/deployment-models.md) | Choosing between single-node, multi-node, embedded, and managed |
| [Docker](/docs/running/docker.md) | Quickest path; SurrealKV with a volume mount |
| [Kubernetes](/docs/operate/self-hosted/kubernetes.md) | Single SurrealDB pod with SurrealKV on a persistent volume |
| [Managed Kubernetes](/docs/operate/self-hosted/managed-kubernetes.md) | Paths on Amazon EKS, Google GKE, and Azure AKS |
| [SurrealDS on Kubernetes](/docs/operate/enterprise/product/surrealds/kubernetes-operator.md) | Multi-node cluster with the SurrealDB operator (Enterprise) |
| [SurrealDS on your own machines](/docs/operate/enterprise/product/surrealds/own-machines.md) | Multi-node cluster on servers or virtual machines without Kubernetes (Enterprise) |

Most self-hosted workloads store data on disk, with one SurrealDB process per database directory. From SurrealDB 4.0 the on-disk engine is **SurrealKV** (`surrealkv://`). RocksDB (`rocksdb://`) was removed in SurrealDB 4.0; see [Moving a RocksDB database to SurrealKV](/docs/operate/self-hosted/deployment-models.md#moving-a-rocksdb-database-to-surrealkv).

## Operating a self-hosted instance

- [Configuration](/docs/operate/self-hosted/configuration.md) - server startup options, environment variables, and storage engine selection.
- [Backups and recovery](/docs/operate/self-hosted/backups-and-recovery.md) - export and import commands, backup strategies, and disaster recovery.
- [Monitoring and observability](/docs/operate/self-hosted/monitoring-and-observability.md) - health endpoints, metrics, and tracing integration.
- [Upgrades and patching](/docs/operate/self-hosted/upgrades-and-patching.md) - version upgrades, major-version data migration, and compatibility notes.

Once an instance is running, the [Observability](/docs/operate/observability.md) section covers the built-in metrics, audit logs and slow-query logs you can scrape over Prometheus or push over OTLP for production monitoring.

## Enterprise Edition

Self-hosted clusters can run [Enterprise Edition](/docs/operate/enterprise/product/database-enterprise.md), which adds distributed live queries, audit logging, FIPS-validated cryptography and support tiers on top of the same server. Enterprise also includes [SurrealDS](/docs/operate/enterprise/product/surrealds.md), the distributed storage engine for self-hosted multi-node clusters.
