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
+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 --geneTop issues
#1997clients report: Already Closed10 comments · 2024-06-14#930Query Row History7 comments · 2021-09-23#1883The immudb logs are not availabe6 comments · 2023-11-29#1350GetAll is not failing under keynotfound6 comments · 2022-08-29#1183Grpc Message Size Constraints5 comments · 2022-04-15#1771Enabling mtls create issue with https web service4 comments · 2023-08-17#1691Technical documentation for documents store4 comments · 2023-06-06#1071wordpress support available with Plugin or tutorial? 4 comments · 2021-12-29
Discussions
#2162Commercial use of immudb as a backend for a tamper-proof log manager0 comments · 2026-09-29#2160Unsure about the licence1 comments · 2026-09-23#2084Prevent UPDATE and DELETE Commands in ImmuDB SQL Mode to Ensure Audit Integrity4 comments · 2025-12-22#2083ImmuGORM Repo Does Not Exist0 comments · 2025-12-18#2078Session Not Found and Permission Error Despite Using KeepAlive in ImmuDB1 comments · 2025-10-21#2070Immudb in kubernetes cluster0 comments · 2025-09-02#2043How to load large datasets? Corrupted database0 comments · 2025-01-13#2024Test against over spending5 comments · 2024-09-15
Latest release
immudb version 1.11.2 v1.11.2 2026-09-03immudb — 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 (