eloqdata / eloqkv

--- EloqKV 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. This repo contains the code for the pluggable Redis API layer. See Architecture for more details. The API sits on top of EloqData's Data Substrate modular database foundation and the dependencies are included as submodules. • Key Features • Quick Start • Architecture • Benchmark • Build From Source • License • See Also **Why Choose EloqKV Over Redis?** | Feature | Redis | EloqKV | | ---------------------------- | ----------------------------- | ---------------------------------------------- | | **High Performance** | Single-threaded | Multi-threaded (1.6million QPS on c6g.8xlarge) | | **Transactions** | (No Rollback) | Redis API plus (ACID) | | **Distributed Transactions** | Error | ACID distributed transactions | | **Data Durability** | Limited, AOF/RDB snapshots | Replicated WAL + Tiered Storage | | **Cold Data** | Must fit in memory | Auto-tiering to disk | | **Client Transparency** | Cluster needs specific client | Same client for a single server or a cluster | --- Key Features High Performance • **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. Full Durability with Tiered Storage • **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.* ACID Transactions with Session-Style Syntax In addition to the standard (but limited) Redis transaction syntax (MULTI/EXEC), EloqKV also support Session-style interactive transactions. • No more Lua scripts or limitations — write transactions like a SQL database, with similar ACID gurantees and better performance. Distributed ACID Transactions **Cross-node strong consistency without constraints** • **No Errors**：Enables atomic operations across multiple nodes, unlike Redis Cluster which blocks cross-slot transactions. Redis API Compatibility • Zero code changes needed. Check out our supported Redis commands. --- Quick Start Using Docker We recommend using Docker for a quick local try-out of EloqKV. **1. Start a Single Node using Docker:** > **Note**: EloqKV enables by default for high performance. To avoid initialization errors on some platforms (e.g., macOS Docker), you must run with and set custom ulimits. **Or using Docker Compose:** Create a file: Start the container: **2. Verify Installation:** 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. --- Architecture 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. Benchmark 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. Cache Mode 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 Persistent Transactional Mode 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 --- Build from Source • Pull the Source Code and Install Dependencies 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. 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. • Initialize Submodules • Build EloqKV • Run EloqKV --- License EloqKV is released under a dual license. You may choose to use it under the terms of either: • GNU General Public License, Version 2 (GPLv2), or • GNU Affero General Public License, Version 3 (AGPLv3). See the LICENSE file for details. --- See Also • 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!