Choose Docker for the fastest local setup, or Linux packages for a persistent install. On Ubuntu 24.04 and EL9 (Rocky Linux, AlmaLinux, CentOS Stream, or registered Red Hat Enterprise Linux), the packages install the full DocumentDB stack — the PostgreSQL extension, the wire-protocol gateway, the administrator tools and systemd units. Starting with v0.116, the hosted package matrix is intentionally smaller and mirrors only combinations attached to the current official release.
Starts DocumentDB locally on port 10260 for quick evaluation and development.
| Format | Distributions | Architectures | PostgreSQL versions | Package naming | Version served |
|---|---|---|---|---|---|
| APT | Ubuntu 24.04 · ubuntu24 | amd64, arm64 | 17, 18 | documentdb-<pg> | 0.116.0 |
| RPM | Rocky/Alma/CentOS Stream 9 or registered RHEL 9 · rpm/rhel9 | x86_64, aarch64 | 17, 18 | documentdb-<pg> | 0.116.0-1 |
Compared with earlier releases, v0.116 reduces the hosted package matrix. The repository contains only package combinations attached to v0.116-0. Other combinations remain build-on-demand targets in the source repository; see the packaging guide to build the package you need from the matching tag.
Use Package Finder above to generate the exact command for your selected target, or see the Linux Packages Quick Start for the supported repository components and install commands written out in full.
documentdb.io no longer publishes packages for Ubuntu 22.04, Debian 11/12/13, RHEL-compatible 8, or PostgreSQL 16. Existing installations keep running, but they receive no package updates and cannot reinstall those packages from the documentdb.io repository.
Empty signed metadata remains at the retired repository URLs so apt update and dnf makecache do not break unrelated package operations. Remove the DocumentDB source if that host will not move to the current matrix:
To remain on an older target, use the matching GitHub release assets or build from that release tag. Those paths are not part of the current hosted support matrix.
Use the commands below to discover available versions before pinning, and pin documentdb-18 — the package your selected target actually installs.
APT and RPM use different version syntax, and individual subpackages can carry different release suffixes. Always copy the exact version returned below for documentdb-18; do not infer it from the extension or another package.
APT — list then pin
apt-cache madison documentdb-18sudo apt install documentdb-18=<VERSION>RPM — list then pin
dnf --showduplicates list documentdb-18sudo dnf install documentdb-18-<VERSION>See all releases and release notes on GitHub Releases.
Individual .deb and .rpm files are attached to each release on GitHub. Recent release examples:
Choose an asset whose PostgreSQL version and architecture match your host.
Browse releases on GitHub →sudo apt update && apt search documentdb && apt-cache policy postgresql-18-documentdbsudo dnf clean all && dnf search documentdb && rpm -qi postgresql18-documentdbDocker starts a gateway-backed local endpoint on port 10260. On Ubuntu 24.04 and EL9 the packages give you the same thing: install, then run sudo documentdb-setup --pg-version 18 --use-new-postgres-instance --admin-user admin, which creates a private database instance for the selected PostgreSQL major and starts the gateway.
See the full setup flow and choose the guide that fits your environment.
Install PyMongo and connect to your local DocumentDB instance.
Use the Node.js driver and run your first queries locally.
Connect through the VS Code extension for a guided local workflow.