EloqKV

Redis-Compatible, Database-Powered — ACID Transactions, Tiered Storage & SQL-Style Syntax, Built for Real Workloads.

Overview

EloqKV is a Redis-compatible database designed for developers who need ACID transactions, tiered storage, and SQL-style syntax — all while keeping Redis' simplicity.

Why Choose EloqKV Over Redis?

Feature	Redis	EloqKV
Transactions	MULTI/EXEC (No Rollback)	BEGIN/COMMIT/ROLLBACK (ACID)
Distributed Transactions	CROSSSLOT Error	ACID distributed transactions
Data Durability	AOF/RDB snapshots	WAL + Tiered Storage
Scalability	Single-threaded	Multi-threaded (1.6million QPS/node)
Cold Data	Memory-only	Auto-tiering to disk

👉 Use Cases: Real-time analytics, financial systems, IoT data streams — anywhere you need Redis’ speed but can’t compromise on reliability.

---

Key Features

🛠️ ACID Transactions with SQL-Style Syntax

Besides the standard Redis transaction syntax (MULTI/EXEC), we also support SQL-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.

🌐 Distributed ACID Transactions

Cross-node strong consistency without hashtag 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.

🗃️ Tiered Storage

• Hot Data: In-memory for microsecond access.
• Cold Data: Automatically offloaded to disk.
  Save 70% on memory costs compared to Redis.

⚡ Vertical & Horizontal Scaling

• Single node: Up to 1.6M QPS (benchmarked on AWS c6g.8xlarge).
• Distributed: Scale horizontally with distributed transactions so that you can still use it as a single node EloqKv.

🔄 Redis API Compatibility

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

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

---

Quick Start with Docker

We recommend using Docker for a quick start with the EloqKV service.

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"

---

Run with EloqCtl

EloqCtl is the cluster management tool for EloqKV.

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

---

Run with Tarball

Download the EloqKV tarball from the EloqData website.

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

---

Build from Source

1. Install Dependencies:

We recommend using our Docker image with pre-installed dependencies for a quick build and run of EloqKV.

docker pull eloqdata/eloq-build-ubuntu2404:latest

Or, you can manually run the following script to install dependencies on your local machine.

bash scripts/install_dependency_ubuntu2404.sh

2. Initialize Submodules

Fetch the Transaction Service and its dependencies:

git submodule update --init --recursive

3. Build EloqKV

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=./install -DWITH_KV_STORE=ROCKSDB ..
make -j
make install

4. Run EloqKV

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

---

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