Linux

Prerequisites

Linux with systemd (Ubuntu 22.04 LTS or later recommended)
unzip and node installed
8 GB RAM (16 GB+ recommended)
10 GB disk space (100 GB+ recommended)

Install VectorAI DB

x86-64 (AMD/Intel)
ARM64

Extract the tarball

Download Actian-VectorAI-linux-x64-1.0.0.tar.gz from the Actian VectorAI DB downloads page after signing up, then run:

tar -xzf Actian-VectorAI-linux-x64-1.0.0.tar.gz -C /usr/local

This creates the following structure:

/usr/local/actian-vectorai/install/
├── cortex-core-linux-x64-1.0.0-package.tar.gz
├── cortex.web-linux-x64-nightly-20260425.zip
├── install_actian_vectorai.sh
└── uninstall_actian_vectorai.sh

Run the installer

cd /usr/local/actian-vectorai/install
sudo bash install_actian_vectorai.sh

The installer prompts you to accept the EULA. Enter y to continue.To skip the prompt in automated environments:

sudo ACCEPT_ACTIAN_VECTORAI_EULA=YES bash install_actian_vectorai.sh

When complete, the installer prints:

[timestamp] Install completed successfully

Extract the tarball

Download Actian-VectorAI-linux-arm64-1.0.0.tar.gz from the Actian VectorAI DB downloads page after signing up, then run:

tar -xzf Actian-VectorAI-linux-arm64-1.0.0.tar.gz -C /usr/local

This creates the following structure:

/usr/local/actian-vectorai/install/
├── cortex-core-linux-arm64-1.0.0-package.tar.gz
├── cortex.web-linux-arm64-nightly-20260425.zip
├── install_actian_vectorai.sh
└── uninstall_actian_vectorai.sh

Run the installer

cd /usr/local/actian-vectorai/install
sudo bash install_actian_vectorai.sh

The installer prompts you to accept the EULA. Enter y to continue.To skip the prompt in automated environments:

sudo ACCEPT_ACTIAN_VECTORAI_EULA=YES bash install_actian_vectorai.sh

When complete, the installer prints:

[timestamp] Install completed successfully

The REST API is available at localhost:6573. The Local UI is available at localhost:6575.

Verify installation

Run these commands in a terminal after installation completes.

# Check service status
systemctl status actian-vectorai
systemctl status actian-vectorai-webui

# Check the engine API
curl http://localhost:6573/

# List collections
curl http://localhost:6573/collections

A successful response from curl http://localhost:6573/ looks like this:

{
  "title": "Actian VectorAI DB",
  "version": "Actian VectorAI DB 1.0.0 / VDE 1.0.0",
  "commit": ""
}

Troubleshooting

Issue	Solution
Services not running after install	Run `sudo systemctl start actian-vectorai actian-vectorai-webui`
Port 6573 / 6574 / 6575 already in use	Find the process: `sudo lsof -i :6573`, then stop it or change the port
Missing prerequisites error	Run `sudo apt install -y unzip nodejs` and re-run the installer
Connection refused	Wait a few seconds for the services to initialize, then retry
Engine logs	`journalctl -u actian-vectorai`

Check service status

systemctl status actian-vectorai
systemctl status actian-vectorai-webui

# Restart a service if needed
sudo systemctl restart actian-vectorai

Uninstall

Run the uninstall script included with the installer:

sudo bash /usr/local/actian-vectorai/install/uninstall_actian_vectorai.sh

Next steps

Quickstart

Create your first collection, insert vectors, and run a search.

Core concepts

Understand the data model, architecture, and how search works.

Python SDK

Install and configure the Python SDK.

Get started

SDKs

Tools

Guides

Integrations

Support

Legal

Prerequisites

Install VectorAI DB

Verify installation

Troubleshooting

Check service status

Uninstall

Next steps

Quickstart

Core concepts

Python SDK

​Prerequisites

​Install VectorAI DB

​Verify installation

​Troubleshooting

​Check service status

​Uninstall

​Next steps

Quickstart

Core concepts

Python SDK

Prerequisites

Install VectorAI DB

Verify installation

Troubleshooting

Check service status

Uninstall

Next steps