DynamoDB-compatible API adapter backed by your own MongoDB 7+ replica set
2.1K
ExtendDB is a DynamoDB-compatible API server backed by your MongoDB deployment. This image contains ExtendDB only; MongoDB is a separate service that you choose and operate, including MongoDB Atlas or a self-managed replica set.
The MongoDB backend requires MongoDB 7.0 or newer configured as a replica set. Transactions and change streams are used by the backend, so a standalone MongoDB server is not sufficient.
Pull the image:
docker pull docker.io/extenddb/extenddb-mongodb:latest
Create a writable configuration directory and initialize it against your MongoDB deployment:
mkdir -p ./extenddb-data
cat > ./extenddb-data/extenddb.toml <<'EOF'
[storage]
backend = "mongodb"
[storage.mongodb]
connection_string = "mongodb://mongodb.example.com:27017/?replicaSet=rs0"
EOF
docker run --rm \
-v "$PWD/extenddb-data:/var/lib/extenddb" \
docker.io/extenddb/extenddb-mongodb:latest \
init --backend mongodb \
--config /var/lib/extenddb/extenddb.toml \
--overwrite \
--bind-addr 0.0.0.0 \
--tls-san localhost \
--tls-san 127.0.0.1
Start the server using the generated configuration:
docker run --rm --name extenddb-mongodb \
-p 127.0.0.1:18443:18443 \
-v "$PWD/extenddb-data:/var/lib/extenddb" \
--read-only \
--tmpfs /tmp:rw,noexec,nosuid,size=64m \
--cap-drop=ALL \
--security-opt=no-new-privileges:true \
docker.io/extenddb/extenddb-mongodb:latest \
serve --config /var/lib/extenddb/extenddb.toml --foreground
The server listens on https://127.0.0.1:18443 by default. Initialization
creates a self-signed certificate and the first administrator credentials;
save the password printed by init.
Keep the MongoDB connection string in the generated configuration or provide it through the configuration mechanisms documented in the repository. Use MongoDB authentication and TLS for production deployments. The ExtendDB container runs as an unprivileged user and is designed to run with a read-only root filesystem.
For a complete deployment guide and an optional local reference stack, see
docker/README-mongodb.md.
Pin X.Y.Z or a digest for production; a version tag is never overwritten.
latest tracks the highest release and only moves forward. Tags of the form
sha-<commit> are unpromoted build candidates, not releases. Both
linux/amd64 and linux/arm64 ship as one multi-architecture index.
Every published image is signed with Sigstore cosign, with a Rekor
transparency-log entry. Releases through 0.1.14 use a committed release key,
extenddb-signing.pub.pem:
cosign verify --key extenddb-signing.pub.pem \
docker.io/extenddb/extenddb-mongodb:X.Y.Z
From 0.1.15, signatures are keyless: the certificate names the GitHub Actions workflow and ref that signed the image, and no public key is needed.
cosign verify \
--certificate-identity-regexp '^https://github\.com/ExtendDB/extenddb/\.github/workflows/(release-image|sign-image)\.yml@refs/heads/main$' \
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
docker.io/extenddb/extenddb-mongodb:X.Y.Z
The signer identity separates tiers: routine backend releases are signed by
release-image.yml and routine dev releases by release-dev-image.yml, so
this pattern rejects a routinely-signed dev image. The break-glass signer
sign-image.yml can sign any tier, so it is the one identity both patterns
share; drop it to pin verification to the routine per-tier path. The same
images and their signatures are mirrored by digest to
ghcr.io/extenddb/extenddb-mongodb and public.ecr.aws/extenddb/extenddb-mongodb.
ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB and does not contain any DynamoDB source code. It is not an AWS service. "DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is a clean-room implementation that speaks the DynamoDB wire protocol; behavioral differences from the service are documented in Differences from DynamoDB.
More at extenddb.org and github.com/ExtendDB/extenddb. Licensed under Apache-2.0.
Content type
Image
Digest
sha256:bf3db072f…
Size
58.9 MB
Last updated
about 7 hours ago
docker pull extenddb/extenddb-mongodb