---
title: "Migrating to SurrealDB"
description: "Moving data into SurrealDB from other databases, or older releases. Also from files and streams."
canonical_url: "https://surrealdb.com/docs/integrate/migrating"
section: "Migrating to SurrealDB"
surrealdb_version: "4.x"
last_modified: "2026-11-18T02:09:16Z"
---

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

# Migrating to SurrealDB

Moving data into SurrealDB from other databases, or older releases. Also from files and streams.

This section describes how to move data into SurrealDB: from other databases, from older SurrealDB versions, and from files or streams (for example CSV, JSON Lines, or Kafka). Use the subsections for the path that matches your source.

## In this section

<img src="~/assets/img/diagrams/light/hub-migrating-sources-light.webp" darkSrc="~/assets/img/diagrams/hub-migrating-sources.webp" alt="Other databases, such as PostgreSQL, MySQL, MongoDB, Neo4j and Snowflake, and files and streams, such as CSV, JSON Lines and Kafka, move into SurrealDB through Surreal Sync. An older SurrealDB reaches a newer one by following the upgrade guide for each version. A database that Surreal Sync does not cover can be exported as JSON and loaded with surreal import." />

- [Upgrading](/docs/operate/upgrading/overview.md) - how to upgrade, and the guide for each version change: [1.x to 2.x](/docs/operate/upgrading/1x-to-2x.md), [2.6 to 2.7](/docs/operate/upgrading/26-to-27.md), [2.x to 3.x](/docs/operate/upgrading/2x-to-3x.md), [3.2 to 3.3](/docs/operate/upgrading/32-to-33.md) and [3.x to 4.0](/docs/operate/upgrading/3x-to-4x.md)
- [From files and streams](/docs/integrate/migrating/from-files-and-streams.md) - load data held in files or arriving as a stream
- [From other databases](/docs/integrate/migrating/from-other-databases/overview.md) - move across from another database engine

## Moving between SurrealDB Cloud instances

A Free instance moves to a paid instance type in place, from the **Compute** tab of its settings, with no migration. See [Scaling](/docs/operate/instances/scaling.md#scaling-a-start-instance).

Moving from Start to Scale, or to another region, needs a new instance. Deploy it, then [restore a backup](/docs/operate/instances/backups.md) or [import an export](/docs/operate/instances/import-and-export.md) into it.
