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
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
Create or update
/etc/yum.repos.d/aerospike.repo
with the following content to add Aerospike jFrog to your config manager:[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-mdInstall with
yum
ordnf
.sudo yum install aerospike-vector-search
Debian or Ubuntu
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
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.listReload local packages.
sudo apt update
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