Skip to main content

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+


  • Java 21 or higher
  • A running Aerospike cluster

The instructions below assume you have a running Aerospike cluster. You will need to provide credentials for your cluster in step 5.

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:

  2. Install with yum or dnf.

    sudo yum install aerospike-proximus

Debian or Ubuntu

  1. Add the Aerospike public key to your keyring.

    wget -qO - | sudo gpg --dearmor -o /usr/share/keyrings/aerospike.gpg
  2. Add the repository source

    echo 'deb [signed-by=/usr/share/keyrings/aerospike.gpg] 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-proximus

4. Verify AVS feature-key

Ensure that your feature-key file features.conf is in /etc/aerospike-proximus/ and includes the vector-service feature, as shown in the following example. Without that service, AVS will not start.

# generated 2024-02-23 19:31:59

feature-key-version 2
serial-number 12345

account-name Your Company
account-ID vector-trial

valid-until-date 2025-01-15

asdb-change-notification true
asdb-cluster-nodes-limit 0
asdb-compression true
asdb-encryption-at-rest true
asdb-flash-index true
asdb-ldap true
asdb-pmem true
asdb-rack-aware true
asdb-secrets true
asdb-strong-consistency true
asdb-vault true
asdb-xdr true
database-recovery true
elasticsearch-connector true
graph-service true
mesg-jms-connector true
mesg-kafka-connector true
presto-connector true
pulsar-connector true
spark-connector true
vector-service true

----- SIGNATURE ------------------------------------------------
MEY... ...mJA==
----- END OF SIGNATURE -----------------------------------------

5. Configure AVS

AVS uses a single configuration file, aerospike-proximus.yml, located by default in /etc/aerospike-proximus/. 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-proximus service. You can start the service manually or enable the service to start automatically when the system restarts.

Start AVS

sudo systemctl start aerospike-proximus

Enable AVS on system restart

sudo systemctl enable aerospike-proximus