Upgrading
When moving to a new version of SurrealDB, it is important to follow the upgrade instructions to ensure that your data is migrated correctly. This page contains information on how to upgrade your SurrealDB installation.
Upgrading in general
Upgrading the SurrealDB server itself is done through a single command: surreal upgrade. For minor versions, a read through the release notes will suffice to see which breaking changes may exist.
To see the exact PRs that were merged between two versions, you can compare the changes between one version tag and another on GitHub. For example, this link will show you which PRs were merged between versions 3.0.0 and 3.0.2.
As the tags themselves are contained in the url, you can simply replace the numbers to see the details between one version and another.
https://github.com/surrealdb/surrealdb/compare/v3.0.0...v3.0.2
https://github.com/surrealdb/surrealdb/compare/v2.4.0...v2.6.2
Upgrading between major versions (currently 1.x to 2.x and 2.x to 3.x) contains more structural changes and breaking changes, so be sure to see the dedicated pages when upgrading to 2.x or 3.x.
Upgrading to 2.x
If you are upgrading to the 2.x release of SurrealDB, you will need to follow the steps outlined in the upgrading to 2.x guide.
Upgrading to 3.x
If you are upgrading to the 3.x release of SurrealDB, you will need to follow the steps outlined in the upgrading to 3.x guide.
