NeurondB Installation Guide

Complete installation instructions for all supported platforms

Prerequisites

System Requirements

• PostgreSQL 16, 17, or 18
• Minimum 4GB RAM (8GB+ recommended)
• SSD storage for optimal index performance
• Network access for model downloads

Build Dependencies

• GCC 7.0+ or Clang 10.0+
• PostgreSQL development headers
• libcurl (for ML model runtime)
• OpenSSL (for encryption)
• zlib (for compression)

Ubuntu / Debian

Step 1: Install PostgreSQL

sudo apt-get update
sudo apt-get install -y postgresql-17 \
    postgresql-server-dev-17 \
    postgresql-contrib-17

Step 2: Install Build Dependencies

sudo apt-get install -y \
    build-essential \
    libcurl4-openssl-dev \
    libssl-dev \
    zlib1g-dev \
    pkg-config

Step 3: Build and Install

git clone https://github.com/pgElephant/NeurondB.git
cd NeurondB
make PG_CONFIG=/usr/lib/postgresql/17/bin/pg_config
sudo make install PG_CONFIG=/usr/lib/postgresql/17/bin/pg_config

Step 4: Verify Installation

ls -lh /usr/lib/postgresql/17/lib/neurondb.so
ls -lh /usr/share/postgresql/17/extension/neurondb*

macOS

Step 1: Install PostgreSQL via Homebrew

brew install postgresql@17
brew services start postgresql@17

Step 2: Build and Install

git clone https://github.com/pgElephant/NeurondB.git
cd NeurondB
make PG_CONFIG=/opt/homebrew/opt/postgresql@17/bin/pg_config
sudo make install PG_CONFIG=/opt/homebrew/opt/postgresql@17/bin/pg_config

Rocky Linux / RHEL

Step 1: Install PostgreSQL

sudo dnf install -y \
    postgresql17-server \
    postgresql17-devel \
    postgresql17-contrib

Step 2: Install Build Dependencies

sudo dnf install -y \
    gcc \
    make \
    curl-devel \
    openssl-devel \
    zlib-devel

Step 3: Build and Install

git clone https://github.com/pgElephant/NeurondB.git
cd NeurondB
make PG_CONFIG=/usr/pgsql-17/bin/pg_config
sudo make install PG_CONFIG=/usr/pgsql-17/bin/pg_config

Post-Installation

-- Connect to your database
psql -d mydb

-- Create extension
CREATE EXTENSION neurondb;

-- Verify installation
SELECT extversion FROM pg_extension WHERE extname = 'neurondb';

Getting Started Guide Learn Vector Types

Troubleshooting

• Build fails: Ensure PostgreSQL development headers are installed
• Extension not found: Verify PG_CONFIG path points to correct PostgreSQL version
• Permission denied: Use sudo for make install step
• Missing libraries: Install all build dependencies listed above