Skip to content
DocumentDB 1.0: Open-Source PostgreSQL Document DB with MongoDB Wire Compatibility
Databases 6 min read

DocumentDB 1.0: Open-Source PostgreSQL Document DB with MongoDB Wire Compatibility

Microsoft's DocumentDB 1.0 releases as an MIT-licensed PostgreSQL extension and gateway compatible with MongoDB wire protocol, offering Kubernetes support, security focus, and a permissive license alternative to MongoDB's SSPL, while benchmarks show mixed performance versus MongoDB and FerretDB.

21CTO
21CTO
21CTO

DocumentDB 1.0 Release Overview

DocumentDB 1.0, released on November 14, 2026, is the first production-ready version of an open-source document database built on PostgreSQL under the MIT license. It comprises a PostgreSQL extension that implements MongoDB-compatible API functionality and a gateway that translates MongoDB wire protocol requests into PostgreSQL calls. Most MongoDB drivers, tools, and queries work without modification.

DocumentDB architecture diagram
DocumentDB architecture diagram

Architecture and Compatibility

The system supports PostgreSQL versions 15 through 18 via container images, with Linux packages for PostgreSQL 17 and 18. A Kubernetes Operator is included for orchestration. The GA release emphasizes security, stability, and fixes for indexing, aggregation, and geospatial queries.

Origins and Governance

Microsoft announced the project in early 2025 to provide a PostgreSQL-based NoSQL data store with fully open architecture and implementation. Months later, the project joined the Linux Foundation, gaining backing from AWS, Cockroach Labs, Google, Snowflake, and Yugabyte.

Licensing Contrast

The team highlights that the permissive MIT license allows commercial use, modification, and hosting without requiring disclosure of proprietary code, contrasting with MongoDB's Server Side Public License (SSPL).

Naming Confusion

The project maintains a page distinguishing the open-source Azure DocumentDB from Azure Cosmos DB, yet community confusion persists. On Hacker News, user marifjeren noted that "DocumentDB" is already widely used to refer to Amazon DocumentDB.

Naming confusion illustration
Naming confusion illustration

Ecosystem Positioning

Microsoft product manager Patty Chow explained that MongoDB's familiar drivers and query patterns are worth preserving, and alternative implementations let developers evaluate different storage and deployment approaches while leveraging existing knowledge. DocumentDB provides its own PostgreSQL extension and MongoDB-compatible gateway. FerretDB, a separate project, uses the DocumentDB extension as a backend with its own MongoDB-compatible interface. A Reddit user reported that compatibility between MongoDB and FerretDB is far lower than expected, and expressed satisfaction with Microsoft's support for FerretDB.

Performance Benchmarks

Layerbase conducted preliminary YCSB benchmark comparisons between FerretDB and PostgreSQL-based DocumentDB. DocumentDB showed 20% to 33% higher read throughput, while FerretDB achieved lower update tail latency under mixed workloads. Layerbase cautioned that results are not yet conclusive.

A public GitHub issue reported that DocumentDB 1.0 exhibits higher query latency than MongoDB 9.0.4 across multiple workloads, though these results have not been independently verified.

Release Details and Future Plans

Release notes include upgrade paths and known issues. The project plans to establish independent long-term support and development processes, with versioning strategy still under discussion.

Extensibility for AI Workloads

With DocumentDB reaching 1.0, developers can build applications on a PostgreSQL-backed document store that is highly extensible and supports diverse workloads, including vector databases and frameworks for generative models, enabling better support for intelligent agents and expanding deployment scenarios.

Original Source

Signed-in readers can open the original source through BestHub's protected redirect.

Sign in to view source
Republication Notice

This article has been distilled and summarized from source material, then republished for learning and reference. If you believe it infringes your rights, please contactadmin@besthub.devand we will review it promptly.

Kubernetesvector databasePostgreSQLBenchmarkMIT licenseopen source databaseDocumentDBMongoDB compatibility
Reader feedback

How this landed with the community

Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.