HUB
Sign inSign up
eventsourcingdb logo

thenativeweb/eventsourcingdb

By thenativeweb

•Updated about 15 hours ago

EventSourcingDB – because it's more than just data

Image
Databases & storage
53

50K+

thenativeweb/eventsourcingdb repository overview

⁠EventSourcingDB

EventSourcingDB is a purpose-built database for event sourcing – designed to store, query, and observe event streams with strong consistency, clear semantics, and operational simplicity.

This image provides the official Docker distribution of EventSourcingDB.
It is suitable for development, testing, and production deployments.

📘 Full documentation⁠

⁠Quick Start (Local Development)

Start EventSourcingDB in seconds using Docker:

docker run -it -p 3000:3000 \
  thenativeweb/eventsourcingdb:<VERSION> run \
  --api-token=<API_TOKEN> \
  --data-directory-temporary \
  --http-enabled \
  --https-enabled=false \
  --with-ui

Replace the placeholders:

  • <VERSION>: Docker image tag to use (e.g. 1.3.0)
  • <API_TOKEN>: Choose any short string for local use (e.g. secret)

Open the management UI at http://localhost:3000⁠

⚠️ Do not use this configuration in production.
It uses HTTP, a temporary data directory, and a weak API token – all insecure for real-world use.

⁠Production Deployment

To run EventSourcingDB securely in production, configure the container with:

  • TLS encryption using your own certificate and private key
  • A persistent volume for long-term event storage
  • A strong API token to control access
  • HTTP disabled to avoid unencrypted connections
  • Proper restart behavior using --restart always and --init

🛠️ See the production deployment guide⁠ for complete instructions and example commands.

⁠Upgrading From 1.2 or Earlier

Since version 1.3, the image runs as the user nonroot (UID 65532) instead of esdb (UID 100, GID 101). A data directory that an earlier version wrote has to be handed over to the new user once, or the container has to run as the old user.

Back up the data directory before upgrading: a data directory that 1.3 has opened cannot be opened by an earlier version again.

🔄 See Upgrading a Docker deployment⁠ for the exact steps, including those for Kubernetes.

⁠Key Features

  • Append-only event storage with strict immutability and global ordering
  • Atomic writes across multiple streams with built-in concurrency control
  • CloudEvents-compliant HTTP API for writing, reading, and observing events
  • Replay and filtering with pagination and time-based navigation
  • Snapshots and versioned schemas for evolving systems
  • Secure by default: HTTPS enabled, API token protected, read-only fallback on license expiry
  • Minimal operational footprint: no brokers, no coordination layer, no external runtime
  • Observability and automation: supports OpenTelemetry, Prometheus, and container orchestration
  • Runs anywhere: Linux, macOS, Windows; x86 and ARM; Docker or binary

⁠Licensing

EventSourcingDB is free for small projects (up to 25,000 events).
A commercial license is required for larger projects.

📄 Licensing details⁠
📬 Contact us: [email protected]⁠

⁠Need Help?

We support teams with architecture, integration, scaling, and operations.

Feel free to reach out: [email protected]⁠

Tag summary

Content type

Image

Digest

sha256:036213845…

Size

11.8 MB

Last updated

8 days ago

docker pull thenativeweb/eventsourcingdb