Release 2.4 | SurrealDB

2.4.0

Released on Nov 24, 2025

Features:

Bug fixes:

Breaking changes:

CONTAINS/INSIDE planning made consistent with substring semantics - see language test example in this file with details on using the CONTAINSANY operator with indexes

Upgrade or install

Get SurrealDB v2.4.0

Pick how you want to install or upgrade. Surrealist can update connected instances in place, or choose a platform below to copy a CLI command for v2.4.0.

You can upgrade your SurrealDB Cloud instance to v2.4.0 effortlessly through the Surrealist app.

Open the Surrealist app
Select your organisation and instance
On the dashboard, click on the "Upgrade" button
Your instance will be updated and restarted automatically

Install via Homebrew, then upgrade in place to v2.4.0.

brew install surrealdb/tap/surreal

surreal upgrade --version 2.4.0

Run the install script - it auto-detects your architecture and fetches v2.4.0.

curl -sSf https://install.surrealdb.com | sh -s -- --version 2.4.0

Pins to v2.4.0. Drop --version to always get the newest stable.

Install via PowerShell, then upgrade in place to v2.4.0.

iwr https://windows.surrealdb.com -useb | iex

surreal upgrade --version 2.4.0

Chocolatey and Scoop are also supported - see the full install guide.

Pull and run the v2.4.0 image directly - no local CLI needed.

docker run --rm --pull always -p 8000:8000 surrealdb/surrealdb:v2.4.0 start

Tag v2.4.0 pins to this exact release. Use :latest to always pull the newest stable.

The CLI can swap any existing install - Homebrew, install script, or manual binary - to v2.4.0.

surreal upgrade --version 2.4.0

Run surreal version afterwards to confirm the new version is active.

Full install guide

Our newsletter

Get tutorials, AI agent recipes, webinars, and early product updates in your inbox every two weeks

Newer release line

2.5

Updated Jan 22, 2026

Older release line

2.3

Updated Sep 19, 2025

All releases