Installation

npm

If you're in a Node.js project - especially if you're replacing dynalite - this is the simplest path:

npm install --save-dev dynoxide

Then run it directly:

npx dynoxide

The package ships platform-specific binaries (the same approach as esbuild and Biome), so there's nothing to compile. It pulls the right binary for your OS at install time.

Homebrew (macOS)

The quickest way on a Mac:

brew install nubo-db/tap/dynoxide

Cargo

If you've got Rust installed:

cargo install dynoxide-rs

For the encrypted build (SQLCipher + OpenSSL):

cargo install dynoxide-rs --no-default-features --features encrypted-full

Pre-built binaries

Grab a binary from the GitHub releases page. Builds are available for Linux (x86_64, aarch64, musl), macOS (Intel and Apple Silicon), and Windows.

curl -fsSL https://github.com/nubo-db/dynoxide/releases/latest/download/dynoxide-x86_64-unknown-linux-gnu.tar.gz | tar xz

GitHub Actions

For CI pipelines, there's a dedicated action:

- uses: nubo-db/dynoxide@v1
  with:
    port: 8000

You can also pre-load a database snapshot:

- uses: nubo-db/dynoxide@v1
  with:
    snapshot-url: https://example.com/test-data.db.zst
    port: 8000

Verify it works

After installing, run:

dynoxide

You should see Listening on 127.0.0.1:8000. That's it - you've got a DynamoDB-compatible endpoint ready to go.

Getting Started

Usage

Reference