Install on Linux

The following installation steps apply to both the Debian (*.deb) and RHEL (*.rpm) packages. Platform-specific instructions are noted where applicable.

You can install AVS on the following Linux distributions:

• RHEL / CentOS 7+
• Ubuntu 18.04+
• Debian 9+

Prerequisites

• Java 21 or higher
• A running Aerospike Database (ASDB) version 7.x cluster

note

You will need to provide credentials for your ASDB cluster when configuring AVS in Step 5 below.

1. Add namespaces required by AVS

The Aerospike Database must include a namespace for AVS internal system data storage and at least one namespace for vector and AVS index storage. See Configure Aerospike Database for AVS for more information.

2. Install Java 21 or later

AVS requires Java 21 or later. If Java 21 is not installed on your system, it is available from a number of distributions such as OpenJDK 21​.

3. Install the AVS package

Use the following steps to download and install the appropriate version of AVS from Aerospike's hosted jFrog instance.

RHEL or CentOS

1. Create or update /etc/yum.repos.d/aerospike.repo with the following content to add Aerospike jFrog to your config manager:

   cat << EOF > /etc/yum.repos.d/aerospike.repo
   [aerospike]
   name=Aerospike
   baseurl=https://aerospike.jfrog.io/artifactory/rpm
   enabled=1
   gpgcheck=1
   gpgkey=https://aerospike.jfrog.io/artifactory/api/security/keypair/aerospike/public
   autorefresh=1
   type=rpm-md
   EOF

2. Install with yum or dnf.

   sudo yum install aerospike-vector-search

Debian or Ubuntu

1. Add the Aerospike public key to your keyring.

   wget -qO - https://aerospike.jfrog.io/artifactory/api/security/keypair/aerospike/public | sudo gpg --dearmor -o /usr/share/keyrings/aerospike.gpg

2. Add the repository source

   echo 'deb [signed-by=/usr/share/keyrings/aerospike.gpg] https://aerospike.jfrog.io/artifactory/deb stable main' \
   | sudo tee /etc/apt/sources.list.d/aerospike.list

3. Reload local packages.

   sudo apt update

4. Install AVS.

   sudo apt install aerospike-vector-search

4. Verify AVS feature-key

Ensure that your feature-key file features.conf is in /etc/aerospike-vector-search/ and includes the vector-service feature. If that service is not enabled, AVS will not start.

5. Configure AVS

AVS uses a single configuration file, aerospike-vector-search.yml, located by default in /etc/aerospike-vector-search/. Specify the AVS configuration options and Aerospike cluster details in this file.

For a complete reference of configuration options, see Configuring AVS.

6. Start AVS

The AVS package includes a systemd service definition. The installation procedure creates an aerospike-vector-search service. You can start the service manually or enable the service to start automatically when the system restarts.

Start AVS

sudo systemctl start aerospike-vector-search

Enable AVS on system restart

sudo systemctl enable aerospike-vector-search