Installation

Install NenDB on your system using our cross-platform installer or build from source using Zig 0.15.1.

System Requirements

Minimum Requirements

• OS: Windows 10+, macOS 10.15+, Linux (Ubuntu 20.04+, CentOS 8+)
• RAM: 512MB available memory
• Storage: 100MB free disk space
• Zig: Version 0.15.1 or higher (for building from source)

Quick Install (Recommended)

The fastest way to get NenDB running is using our installation script:

Unix/Linux/macOS

curl -sSL https://install.nendb.co | bash

Windows PowerShell

iwr https://install.nendb.co/install.ps1 | iex

This will download and install the latest version of NenDB to ~/.local/binon Unix systems or %USERPROFILE%\\.nendb\\bin on Windows.

Manual Installation

1. Download NenDB

Download the latest release for your platform:

Linux x64

nendb-linux-x64.tar.gz

macOS x64

nendb-macos-x64.tar.gz

Windows x64

nendb-windows-x64.zip

2. Extract and Install

Linux/macOS

tar -xzf nendb-*.tar.gz
sudo mv nendb /usr/local/bin/
chmod +x /usr/local/bin/nendb

Windows

1. Extract the ZIP file to a directory (e.g., C:\\nendb\\)
2. Add the directory to your PATH environment variable
3. Restart your command prompt

Build from Source

For the latest features or to contribute to development, build NenDB from source:

Prerequisites

• Zig 0.15.1+ - Download from ziglang.org
• Git - For cloning the repository

Build Steps

# Clone the repository
git clone https://github.com/nen-co/nen-db.git
cd nen-db

# Build in release mode for optimal performance
zig build -Doptimize=ReleaseFast

# Install to system path (optional)
sudo cp zig-out/bin/nendb /usr/local/bin/

Verify Installation

Confirm NenDB is installed correctly:

nendb --version

You should see output similar to:

NenDB v0.2.0-beta (Zig 0.15.1)

✓

Installation Complete!

NenDB is now installed and ready to use. Continue with the Quick Start Guide to create your first graph database.

Troubleshooting

"nendb: command not found"

Make sure NenDB is in your PATH. Add this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Build fails with Zig version error

NenDB requires Zig 0.15.1 or higher. Check your version:

zig version

Update Zig from ziglang.org

Permission denied during installation

Use sudo for system-wide installation, or install to a user directory:

mkdir -p ~/.local/bin && cp nendb ~/.local/bin/

Need more help? Check our GitHub Discussions or file an issue on GitHub.

Was this page helpful?

Join the discussion Report an issue