High-performance, JSON-based relational database built entirely in Rust.
Welcome to RDB - a high-performance, JSON-based relational database built entirely in Rust!
RDB is a modern relational database that combines the power of traditional SQL databases with the simplicity of JSON APIs. Instead of writing SQL strings, you send structured JSON objects to describe your queries.
Download the latest release from GitHub Releases.
| Platform | Method | Command |
|---|---|---|
| Linux (x86_64) | Direct Download | wget https://github.com/muhammad-fiaz/RDB/releases/latest/download/rdb-linux-x86_64 && chmod +x rdb-linux-x86_64 && sudo mv rdb-linux-x86_64 /usr/local/bin/rdb |
| macOS (Intel) | Direct Download | curl -L https://github.com/muhammad-fiaz/RDB/releases/latest/download/rdb-macos-x86_64 -o rdb && chmod +x rdb && sudo mv rdb /usr/local/bin/ |
| macOS (Apple Silicon) | Direct Download | curl -L https://github.com/muhammad-fiaz/RDB/releases/latest/download/rdb-macos-aarch64 -o rdb && chmod +x rdb && sudo mv rdb /usr/local/bin/ |
| Windows (x64) | Direct Download | Download rdb-windows-x86_64.exe and add to PATH |
| Any Platform | From Source | cargo install --git https://github.com/muhammad-fiaz/RDB |
# Download
wget https://github.com/muhammad-fiaz/RDB/releases/latest/download/rdb-linux-x86_64
# Make executable
chmod +x rdb-linux-x86_64
# Move to PATH
sudo mv rdb-linux-x86_64 /usr/local/bin/rdb
# Verify
rdb --version# Intel Macs
curl -L https://github.com/muhammad-fiaz/RDB/releases/latest/download/rdb-macos-x86_64 -o rdb
# Apple Silicon Macs
curl -L https://github.com/muhammad-fiaz/RDB/releases/latest/download/rdb-macos-aarch64 -o rdb
# Make executable and move to PATH
chmod +x rdb
sudo mv rdb /usr/local/bin/
# Verify
rdb --version# Download rdb-windows-x86_64.exe from releases
# Move to a directory in your PATH, e.g.:
Move-Item rdb-windows-x86_64.exe C:\Windows\System32\rdb.exe
# Or create a dedicated directory:
New-Item -ItemType Directory -Path "C:\Program Files\RDB"
Move-Item rdb-windows-x86_64.exe "C:\Program Files\RDB\rdb.exe"
# Add to PATH
$env:Path += ";C:\Program Files\RDB"
# Verify
rdb --version# Initialize RDB
rdb init
# Start server
rdb start
# Create your first table
curl -X POST http://localhost:8080/query \
-H "Content-Type: application/json" \
-d '{
"CreateTable": {
"database": "main",
"table": "users",
"columns": [
{"name": "id", "type": "int", "primary_key": true},
{"name": "name", "type": "string"}
]
}
}'- ✅ Complete CRUD operations (CREATE, SELECT, INSERT, UPDATE, DELETE, DROP)
- ✅ 8 WHERE operators (=, !=, >, <, >=, <=, LIKE, IN)
- ✅ ORDER BY, LIMIT, OFFSET support
- ✅ Batch operations
- ✅ Multi-layer caching (Query cache + Buffer pool + B+ tree)
- ✅ JWT authentication with role-based access control
- ✅ Dynamic configuration via config.toml
- ✅ CLI management tools
- ✅ Database auto-discovery
- ✅ Comprehensive documentation
- ⚡ 100,000 queries/second (cached SELECT)
- 📊 90-98% cache hit rate
- 🚀 10-50x faster JSON parsing vs SQL
- 💾 O(log N) indexed lookups
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 512 MB | 2 GB+ |
| Disk | 100 MB | 1 GB+ |
| CPU | 1 core | 4+ cores |
| OS | Linux 3.2+, macOS 10.12+, Windows 10+ | Latest |
# Use different port
rdb start --port 9090# On Linux/macOS, ensure executable
chmod +x rdb
# On Windows, run as Administrator# Check if server is running
curl http://localhost:8080/
# Check firewall settings- 📖 Docs: https://muhammad-fiaz.github.io/RDB/
- 🐛 Issues: https://github.com/muhammad-fiaz/RDB/issues
- 💬 Discussions: https://github.com/muhammad-fiaz/RDB/discussions
If you encounter any database errors, please report them at: https://github.com/muhammad-fiaz/RDB/issues
Visit GitHub Releases for detailed changes.
Licensed under the Apache License 2.0 - see LICENSE for details.
