DocumentationNanoVaultDB

NanoVaultDB Engine.

Note: Before doing any operation on any table. Users must use USE command to select that database. For example: USE exchange_db. For more information on USE statement visit Link.

How to Run NanoVaultDB on Your Machine

NanoVaultDB only supports Ubuntu 22.04 LTS and above. Choose your preferred installation method below.

Method 1: Clone from GitHub

Clone the repository, optionally compile the C++ engine, and run the binary directly.

1. Clone the repository

git clone https://github.com/programmingGod-byte/NanoVaultDb.git

2. Compile the C++ Engine (Optional)

This part is completely optional — you can use the precompiled binary. However, if you make changes to the codebase (e.g. adding strategies) you must recompile:

./compile.sh

3. Run the Engine

./main.exe

Method 2: Install via Debian Package (.deb)

Download the pre-built .deb package from the GitHub releases page, install it with dpkg, and run the engine with a single command.

1. Install the package

sudo dpkg -i nanodb_pkg.deb

2. Run the Engine

nanodb --db-path "/path/to/db-folder"

Dummy UDP Data Sender (.deb)

The nanodb.deb package ships with a built-in utility called dummy_nanodb_UDPsender that lets you instantly start streaming simulated market tick data into NanoVaultDB over UDP — no custom data pipeline needed. Just pass the target symbol index and the sender handles everything else.

Start the sender for symbol 6

CommandUDP Sender
dummy_nanodb_UDPsender --symbol 6