b1ddcd178e
Added Module field to Command and SubCommand structs. Added MODULE filter options to COMMAND LIST command. Added Module field to all existing commands.
What is EchoVault?
EchoVault is a highly configurable, distributed, in-memory data store and cache implemented in Go. EchoVault aims to provide a rich set of data structures and functions for manipulating data in memory, these data structures include, but are not limited to: lists, sets, sorted sets, hashes, with much more to come in the near future.
EchoVault provides a persistence layer for increased reliability. Both Append-Only files and snapshots can be used to persist data to disk for recovery in case of unexpected shutdowns.
Replication is a core feature of EchoVault and is implemented using the RAFT algorithm, allowing you to create a fault-tolerant cluster of EchoVault nodes to improve reliability. If you do not need a replication cluster, you can always run EchoVault in standalone mode and have a fully capable single node.
EchoVault aims to not only be a server, but to be importable into existing projects in order to enhance them with EchoVault features, this capability is always being worked on and improved.
Speed and reliability are top priorities of Echovault, as a result, we're always working to improve these 2 characteristics. While we might not be there yet, we are consistently working to make gains in this area.
Features
Some key features offered by EchoVault include:
- TLS and mTLS support with support for multiple server and client RootCAs
- Replication clustering using RAFT algorithm
- ACL Layer for user Authentication and Authorization
- Distributed Pub/Sub functionality with consumer groups
- Sets, Sorted Sets, Hashes
- Persistence layer with Snapshots and Append-Only files
We are working hard to add more features to EchoVault to make it much more powerful. Features in the roadmap include:
- Eviction Policies to reduce memory footprint
- Encryption for Snapshot and AOF files
- Streams
- Transactions
- Bitmap
- HyperLogLog
- JSON
- Improved Observability
Installing
Homebrew
To install via homebrew, run:
brew tap echovault/echovaultbrew install echovault/echovault/echovault
Once installed, you can run the server with the following command:
echovault --bind-addr=localhost --data-dir="path/to/persistence/direcotry"
Next, install the client via homebrew.
Binaries
You can download the binaries by clicking the on a release tag and downloading the binary for your system.
Configuration
Checkout the configuration wiki page for the possible configuration flags
Clients
EchoVault uses RESP, which makes it compatible with existing Redis clients.
- CLI Client
- Go (Coming Soon)
- JavaScript/TypeScript (Coming Soon)
- Java (Coming Soon)
- C# (Coming Soon)
Development Setup
Pre-requisites:
- Go
- Docker
- Docker Compose
- x86_64-linux-musl-gcc cross-compile toolchain as the development image is build for an alpine container
Steps:
- Clone the repository.
- If you're on MacOS, you can run
make buld && docker-compose up --buildto build the project and spin up the development docker container. - If you're on another OS, you will have to use
go buildwith the relevant flags for your system.
Contribution
Contributions are welcome! If you're interested in contributing, feel free to clone the repository and submit a Pull Request.
Join the Discord server if you'd like to discuss your contribution and/or be a part of the community.