DynamoDB-compatible API adapter backed by your own PostgreSQL 14+ database
6.2K
ExtendDB is a DynamoDB-compatible API adapter that enables teams to run DynamoDB workloads on their own infrastructure, backed by a PostgreSQL database they operate.
ExtendDB works with your existing DynamoDB API calls. Any AWS SDK, CLI, or tool that talks to DynamoDB talks to ExtendDB unchanged, so you point your client at a different endpoint and nothing else about your code changes. The full surface is there: CRUD, Query, Scan, Batch, Transactions, Streams, TTL, Import and Export, plus SigV4 with IAM-compatible users, roles and policies.
It is an adapter, not a database. This image contains the ExtendDB server compiled with the PostgreSQL backend; you supply PostgreSQL 14 or newer, whether that is RDS, Aurora PostgreSQL, or self-managed. Your data therefore lives somewhere you already know how to back up, replicate, monitor and restore, using tools you already run.
Because it runs on your infrastructure, ExtendDB needs no internet connection, and there are no provisioned throughput, data storage, or data transfer costs. That makes it a fit for self-hosted and air-gapped deployments, for DynamoDB semantics on any cloud that runs PostgreSQL, and for continuous integration against a durable backend rather than an ephemeral one.
For local development, the Compose stack in the repository starts PostgreSQL alongside ExtendDB and runs the one-time bootstrap for you. See local development with Docker Compose.
For a real deployment the image serves three explicit operations: extenddb init once to bootstrap the database, extenddb migrate when upgrading, and extenddb serve in steady state, which is the default command. It listens on port 18443 over TLS, keeps configuration and certificates under /var/lib/extenddb, runs as a non-root user, and supports a read-only root filesystem.
To learn how to configure and operate it, see getting started and the container notes.
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. 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-postgres:X.Y.Z
The earliest releases, 0.1.5 and 0.1.6, predate transparency logging; add --insecure-ignore-tlog=true to verify those two.
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-postgres: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-postgres and public.ecr.aws/extenddb/extenddb-postgres.
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:b26d28659…
Size
56 MB
Last updated
about 5 hours ago
docker pull extenddb/extenddb-postgres