---

EloqKV is a high-performance distributed database with a Redis/ValKey compatible API. It offers features like ACID transactions, full elasticity and scalability, tiered storage, and session-style transaction syntax — all while preserving Redis' simplicity and usability. EloqKV is engineered for developers who need a modern no-compromise database solution to power the next generation of demanding applications in the AI era.

• Key Features
• Quick Start
• Architecture
• Benchmark
• Build From Source
• License
• See Also

Why Choose EloqKV Over Redis?

• Multi-threaded: Built with thread-per-core execution and message-passing architecture to fully utilize modern multicore CPUs.
• Single Node: Up to 1.6M QPS on AWS c6g.8xlarge, comparable to purpose-built cache systems like DragonflyDB and far out-performs Redis and Valkey.
• Natively Distributed: Scale horizontally with distributed transactions, so your application works the same whether it's backed by a single-node EloqKV or a cluster of servers.

• WAL for True Durability: No more data loss due to power failures.
• Hot Data: In-memory for microsecond access.
• Cold Data: Automatically offloaded to disk.
  Save 70% on memory costs compared to pure in-memory cache such as Redis.

In addition to the standard (but limited) Redis transaction syntax (MULTI/EXEC), EloqKV also support Session-style interactive transactions.

-- Transfer funds between accounts atomically  
BEGIN  
  GET user:1000:balance     	 -- returns 1000
  INCRBY user:1000:balance -500  -- returns ok
  INCRBY user:2000:balance +500  -- returns ok
COMMIT  
-- Rollback on failure  

• No more Lua scripts or MULTI limitations — write transactions like a SQL database, with similar ACID gurantees and better performance.

Cross-node strong consistency without hash slot constraints

-- Example of cross-node transfer
BEGIN  
  INCRBY user:1000:balance -500      -- node A  
  HSET order:2000:status "paid"      -- node B  
COMMIT  

• No CROSSSLOT Errors：Enables atomic operations across multiple nodes, unlike Redis Cluster which blocks cross-slot transactions.

redis-cli -h eloqkv-server SET key "value"  # Works out of the box!  

• Zero code changes needed. Check out our supported Redis commands.

We recommend using Docker for a quick local try-out of EloqKV.

1. Start a Single Node using Docker:

# Create subnet for containers.
docker network create --subnet=172.20.0.0/16 eloqnet

docker run -d --net eloqnet --ip 172.20.0.10 -p 6379:6379 --name=eloqkv eloqdata/eloqkv

2. Verify Installation:

redis-cli -h 172.20.0.10

172.20.0.10:6379> set hello world
OK
172.20.0.10:6379> get hello
"world"

EloqCtl is the cluster management tool for EloqKV.

To deploy an EloqKV cluster in production, download EloqCtl and follow the deployment guide.

Download the EloqKV tarball from the EloqData website.

Follow the instruction guide to set up and run EloqKV on your local machine.

EloqKV is a decoupled, distributed database built on Data Substrate, the innovative new database foundation developed by EloqData.

Each EloqKV instance includes a frontend, compatible with the Redis protocol, deployed together with the core TxService to handle data operations. A logically independent LogService handles Write Ahead Logging (WAL) to ensure persistence, while a Storage Service manages memory state checkpoints and cold data storage.

EloqKV is a fully featured key-value database that supports both pure in-memory caching mode and durable transactional mode. In both use cases, it delivers outstanding performance compared to other solutions.

In cache scenarios, on a reasonable modern multi-core server EloqKV significantly outperforms Redis and ValKey and achieves performances comparable to DragonflyDB, a multi-threaded in-memory cache with Redis API. Unlike Redis and DragonflyDB, EloqKV is a full featured database that also excels in clustered, durable, and fully ACID-compliant transactional setups. See full benchmark

When running with full durability, EloqKV outperforms other Redis-compatible stores like Apache KVRocks by a large margin. Unlike these datastores that merely swap cold data to disks, EloqKV offers real, rollback-capable transactions with high throughput and ACID guarantees. See full benchmark

We recommend using our Docker image with pre-installed dependencies and pull EloqKV source code in the container for a quick build and run of EloqKV.

docker pull eloqdata/eloq-dev-ci-ubuntu2404:latest
docker run -it --name eloq eloqdata/eloq-dev-ci-ubuntu2404
git clone https://github.com/eloqdata/eloqkv.git
cd eloqkv

Alternatively, you can also pull the source code in an existing Linux environment (currently, ubuntu2404 is preferred), and manually run the script to install dependencies on your local machine. Notice that this might take a while.

git clone https://github.com/eloqdata/eloqkv.git
cd eloqkv
bash scripts/install_dependency_ubuntu2404.sh

git submodule update --init --recursive

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=./install ..
make -j 8
make install

cd install
./bin/eloqkv --port=6389

EloqKV is released under a dual license. You may choose to use it under the terms of either:

1. GNU General Public License, Version 2 (GPLv2), or
2. GNU Affero General Public License, Version 3 (AGPLv3).

See the LICENSE file for details.

• EloqKV Documentation
• Try EloqCloud for EloqKV
• Watch: EloqKV at ApacheCon
• Watch: EloqKV at Monster Scale Summit

Star This Repo ⭐ to Support Our Journey — Every Star Helps Us Reach More Developers!