Generally available · October 19, 2026

DocumentDB 1.0

The open-source, MongoDB-compatible document database built on PostgreSQL.

Our first generally available release focuses on security, stability and correctness. MIT licensed, with native BSON storage on PostgreSQL.

Install DocumentDB 1.0 Read the announcement

A stabilization release

What's new in 1.0

Full changelog

Security fixes

Tighter permission checks for reads and writes, plus SASLprep password validation.

Stability

Fixes for backend crashes, concurrent index-drop deadlocks and RUM index maintenance. Clearer gateway errors for connection and pool failures.

Collation (opt-in)

More operators honor collation when it is enabled. It is off by default, and some operations don't support it yet.

Known issues

Geospatial correctness

Fixes proximity-query edge cases for nearly coincident points and longitude -180.

Get started

Get started with DocumentDB 1.0

Docker

DocumentDB 1.0 on PostgreSQL 17; images for PostgreSQL 15 to 18 are published too. With Docker running, replace the username and password, then run the command. On Windows, run it in WSL.

bash

docker run -dt --name documentdb \
  -p 127.0.0.1:10260:10260 \
  -e USERNAME='<YOUR_USERNAME>' \
  -e PASSWORD='<YOUR_PASSWORD>' \
  ghcr.io/documentdb/documentdb/documentdb-local:pg17-1.0.0

The image sends usage telemetry by default. Add -e DOCUMENTDB_USAGE_TELEMETRY=false before the image name to turn it off. What is sent · Privacy statement

Docker quick start

Linux packages

Ubuntu 24.04 and EL9, PostgreSQL 17 or 18, amd64 or arm64, from the documentdb.io APT and YUM repositories. On a clean host:

Installer

curl -fsSLo documentdb-install.sh https://documentdb.io/install.sh &&
sudo sh documentdb-install.sh

apt and dnf commands

VS Code

The DocumentDB extension for Visual Studio Code 1.0 sets up DocumentDB Local for you, then lets you browse, query and copy data between connections. Needs desktop VS Code and Docker running.

Open setup in VS Code

Don't have VS Code? Download it first.

VS Code quick start

Kubernetes

The DocumentDB Kubernetes Operator 1.0.0 is generally available alongside the engine. The quick start prepares a cluster, installs cert-manager and the operator, and creates your first DocumentDB database.

Deploy on Kubernetes About the operator

Upgrading

Moving to 1.0

Linux packages from v0.116 or v0.117 upgrade in place. Upgrade steps
Containers: start the 1.0 image on a new volume and reload your data; a newer image does not update an existing volume. Upgrading the image
Release candidates have no upgrade path. Start from a clean host or volume.

Known issues · Release notes · v1.0-0 on GitHub

From the blog

AnnouncementDocumentDB 1.0 is here ToolsDocumentDB extension for Visual Studio Code 1.0 KubernetesDocumentDB 1.0 on Kubernetes VersioningLong-term support or development?

Built in the open

Try 1.0 with a workload that matters to you, and tell us what you find.

Report an issue Join Discord