codenotary /immudb

immudb - immutable database based on zero trust, SQL/Key-Value/Document model, tamperproof, data change history

★ 9,052⑂ 385👁 74⑃ 1,544● 567▤ 55
GoNOASSERTIONCreated 2019-11-07immudb.io
Download: immudb version 1.11.2immudb-1.11.2 ↓1.11.22026-09-03
+0
Daily
9,052
stars
385
forks
74
watchers
1,544
prs
567
issues
55
releases

README

immudb 












Don't forget to ⭐ this repo if you like immudb!

:tada: 157M pulls from docker hub!

---

Detailed documentation can be found at https://immudb.io/docs/

---



immudb is a database with built-in cryptographic proof and verification. It tracks changes in sensitive data and the integrity of the history will be protected by the clients, without the need to trust the database. It can operate as a key-value store, as a document model database, and/or as relational database (SQL).

Traditional database transactions and logs are mutable, and therefore there is no way to know for sure if your data has been compromised. immudb is immutable. You can add new versions of existing records, but never change or delete records. This lets you store critical data without fear of it being tampered.

Data stored in immudb is cryptographically coherent and verifiable. Unlike blockchains, immudb can handle millions of transactions per second, and can be used both as a lightweight service or embedded in your application as a library. immudb runs everywhere, on an IoT device, your notebook, a server, on-premise or in the cloud. For running immudb fully in-process as a Go library — no server, no container — see the embedding guide.


When used as a relational data database, it supports both transactions and blobs, so there are no limits to the use cases. Developers and organizations use immudb to secure and tamper-evident log data, sensor data, sensitive data, transactions, software build recipes, rule-base data, artifacts and even video streams. Examples of organizations using immudb today.


 Contents

- immudb
  - Contents
  - Quickstart
  - Recent Changes
    - Structured Audit Logging
    - DIFF OF SQL Query
    - PostgreSQL SQL Compatibility
    - Security Hardening
  - Using immudb
  - Tech specs
  - Performance figures
  - Roadmap
  - Projects using immudb
  - Contributing

 Quickstart


 Getting immudb running: executable

You may download the immudb binary from the latest releases on Github. Once you have downloaded immudb, rename it to immudb, make sure to mark it as executable, then run it. The following example shows how to obtain v1.9.5 for linux amd64:

bash
wget https://github.com/codenotary/immudb/releases/download/v1.9.5/immudb-v1.9.5-linux-amd64
mv immudb-v1.9.5-linux-amd64 immudb
chmod +x immudb

 run immudb in the foreground to see all output
./immudb

 or run immudb in the background
./immudb -d


 Getting immudb running: Docker

Use Docker to run immudb in a ready-to-use container:

bash
docker run -d --net host -it --rm --name immudb codenotary/immudb:latest


If you are running the Docker image without host networking, make sure to expose ports 3322 and 9497.

 Getting immudb running: Kubernetes

In kubernetes, use helm for an easy deployment: just add our repository and install immudb with these simple commands:

bash
helm repo add immudb https://packages.codenotary.org/helm
helm repo update
helm install immudb/immudb --gene

Top issues

Discussions

Latest release

immudb version 1.11.2 v1.11.2 2026-09-03
immudb — Changes from v1.11.1 to v1.11.2 

v1.11.2 is a small maintenance release. No new user-facing SQL or server features.

 Bug Fixes
- pkg/server: a statement that fails before execution (e.g. a parse error) no longer aborts the surrounding transaction — the ongoing tx now survives (5446534c, with stdlib test 1a5f54e8).
- pkg/database: guard against a nil database in DBManager.CloseAll, which could panic during shutdown (bfa78b34).
- embedded/multiapp: ReadAt is now served from a detached handle when the appendable cache evicts an entry mid-read, fixing a close-while-reading race (

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON