Windows Installation

Install NexaDB on Windows 10/11 using WSL2 or Docker Desktop.

💡

Recommended: WSL2 (Windows Subsystem for Linux)

WSL2 provides the best performance and native Linux experience on Windows. It's the official Microsoft-recommended way to run Linux tools.

🐧

WSL2 (Recommended)

  • ✓ Native Linux performance
  • ✓ Easy updates
  • ✓ Full nexa CLI support
  • ✓ 10-15 minute setup
View Instructions ↓
🐳

Docker Desktop

  • ✓ Isolated environment
  • ✓ Quick to start
  • ✓ Portable setup
  • ✓ 5-10 minute setup
View Instructions ↓

Method 1: WSL2 Installation (Recommended)

Prerequisites

  • • Windows 10 version 2004 or higher (Build 19041+)
  • • Windows 11 (any version)
  • • Administrator access to enable WSL2
  • • 4GB RAM minimum (8GB+ recommended)

Step 1: Install WSL2

Open PowerShell or Windows Command Prompt as Administrator and run:

wsl --install

This command will:

  • • Enable the required Windows features
  • • Install the latest Linux kernel
  • • Set WSL2 as the default version
  • • Install Ubuntu (default distribution)

⚠️ Restart required: After installation, restart your computer.

Step 2: Set Up Ubuntu

After restart, launch Ubuntu from the Start menu. It will complete the installation and ask you to create a user:

# Enter a username (lowercase, no spaces)
Enter new UNIX username: your_username
# Enter a password (you won't see it as you type)
New password: ********

Step 3: Update Ubuntu

Update the package list and upgrade installed packages:

sudo apt update && sudo apt upgrade -y

Step 4: Install NexaDB

Now install NexaDB using our one-line Linux installer:

curl -fsSL https://raw.githubusercontent.com/krishcdbry/nexadb/main/install.sh | bash

This will automatically:

  • • Detect your system architecture
  • • Install Python 3 and dependencies
  • • Download NexaDB server
  • • Install nexa CLI binary
  • • Add commands to your PATH

Step 5: Start NexaDB

nexadb start
✓ Binary Protocol on port 6970 (10x faster!)
✓ JSON API on port 6969 (REST fallback)
✓ Admin UI on port 9999 (Web interface)

Step 6: Access Admin Panel

Open your Windows browser (Chrome, Edge, Firefox) and visit:

http://localhost:9999/admin_panel/
Default credentials:
Username: root
Password: nexadb123

Method 2: Docker Desktop Installation

Prerequisites

  • • Docker Desktop for Windows installed
  • • Windows 10/11 with Hyper-V or WSL2 backend
  • • 4GB RAM minimum (8GB+ recommended)
Download Docker Desktop →

Quick Start

Open PowerShell or Command Prompt and run:

docker run -d --name nexadb -p 6969:6969 -p 6970:6970 -p 9999:9999 -v nexadb-data:/app/nexadb_data krishcdbry/nexadb:latest

For complete Docker instructions including Docker Compose setup, see the Docker Installation Guide.

Using nexa CLI on Windows

WSL2 Method

Open your WSL2 Ubuntu terminal and run:

nexa -u root -p

Full native performance, just like Linux!

Docker Method

Access nexa CLI inside the Docker container:

docker exec -it nexadb nexa -u root -p

Connect to your running NexaDB container.

Troubleshooting

WSL2 Not Installing

Check your Windows version:

winver

You need Windows 10 version 2004+ or Windows 11. Update Windows if needed.

Can't Access localhost:9999 from Windows Browser

If using WSL2, try this in Ubuntu terminal:

ip addr show eth0 | grep inet

Use the displayed IP address instead of localhost (e.g., http://172.x.x.x:9999/admin_panel/)

Port Already in Use

netstat -ano | findstr :6969

Check which process is using the port and kill it, or change NexaDB ports.

Docker Desktop Won't Start

Ensure virtualization is enabled in BIOS and Hyper-V/WSL2 features are enabled in Windows Features.

Next Steps

Now that NexaDB is running on Windows, explore these resources: