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.2.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.

⁠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]⁠