Install Aerospike on Linux
Aerospike Database is optimized for 64-bit Linux distributions, and comes packaged as Red Hat Package Manager (RPM) packages, Debian packages, binary and source tarballs.
See the platform support page for information about the versions currently supported.
Requirements
Aerospike Tools are intended to run on 64-bit Linux distributions, including Red Hat Enterprise Linux (RHEL), CentOS, Rocky Linux, Ubuntu, Debian, Amazon Linux, Oracle Linux and others. See the release notes for information about the required versions.
libcurl
Beginning with Database 5.1, the libcurl
shared library is required.
The expand the following table to show several common Linux distributions and the corresponding packages providing libcurl
.
libcurl packages
Linux distribution | libcurl package name |
---|---|
Amazon Linux 2023 | libcurl |
Debian 11 | libcurl4 |
Debian 12 | libcurl4 |
RHEL 8 (el8 ) | libcurl |
RHEL 8 (el8 ) | libcurl-minimal |
RHEL 9 (el9 ) | libcurl |
RHEL 9 (el9 ) | libcurl-minimal |
Ubuntu 20.04 | libcurl4 |
Ubuntu 22.04 | libcurl4 |
Ubuntu 24.04 LTS | libcurl4 |
Prerequisites
- To install, you must have root access or permission to run
sudo
. - For Aerospike Database 5.1 and later, be sure to install the proper version of
libcurl
. See libcurl Required. - Support for Debian 10 was removed in Database 7.0. Support for Debian 10 ARM64 was removed from Database 6.3.
- To install, you must have root access or permission to run
sudo
. - Starting with Database 7.2, Aerospike gains compatibility with OpenSSL 3.0.13, to support Ubuntu 24.04 LTS.
- Starting with Database 6.3, Aerospike is compatible with OpenSSL 3, supporting Ubuntu 22.04, RHEL 9/CentOS Stream 9, and other Linux distributions that support OpenSSL 3. The Aerospike server and clients retain compatibility with OpenSSL 1.1.
- Be sure to install the proper version of
libcurl
. See libcurl Required.
- SELinux must be permanently disabled or permanently set to
Permissive
mode. - For RHEL 8 (Database 5.7 and later), if you are running a non-standard version of the OS, such as a “stripped down” version to eliminate certain packages for security, Aerospike Enterprise Edition (EE) has certain dependencies that must be satisfied before installation. Refer to CentOS 8 package dependencies.
- Support for CentOS 7 was removed in Database 7.0. For CentOS, the Aerospike installation files are built with OpenSSL version 1.02. Aerospike will fail on earlier versions of OpenSSL.
- To install, you must have root access or permission to run
sudo
. - For Database 5.1 and later, be sure to install the proper version of
libcurl
. See libcurl Required.
Download Aerospike Database
Download the Aerospike Database software manually from the download page. Make sure to read the release notes of the version you are downloading. Alternatively, you can automate downloading versions of the server from the artifact repository. See the FAQ on downloads for details.
Base URL
https://download.aerospike.com/artifacts/aerospike-server-edition/server-version/
Starting with Database 6.2 where support for 64-bit ARM is introduced, the server package follows the following naming convention:
aerospike-server-edition_server-version_tools-tools-version_distro_architecture.tgz
Name | Options |
---|---|
edition | community | enterprise | federal |
server-version | 6.2.0.0 , and so on |
tools-version | 8.0.2 and later |
distro | debian10 | debian11 | debian12 |
architecture | amd64 | arm64 |
Name | Options |
---|---|
edition | community | enterprise | federal |
server-version | 6.2.0.0 , and so on |
tools-version | 8.0.2 and later |
distro | ubuntu18.04 | ubuntu20.04 | ubuntu22.04 |
architecture | amd64 | arm64 |
Name | Options |
---|---|
edition | community | enterprise | federal |
server-version | 6.2.0.0 , and so on |
tools-version | 8.0.2 and later |
distro | el7 | el8 | el9 | amzn2023 |
architecture | x86_64 | aarch64 |
wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/6.2.0.0/aerospike-server-enterprise_6.2.0.0_tools-8.0.2_el9_x86_64.tgz
Extract the package
To extract the contents of the package, run the following:
tar -xvf aerospike.tgz
The contents are extracted to a directory with a name similar to the following, where community_or_enterprise
depends on the version of the server you downloaded:
The directory includes:
license.txt
— licenses for Aerospike and other software included in the package- Tools RPM — Aerospike command-line tools and utilities
- Server RPM — the Aerospike Database package
Install
To install the server and the tools packages, run the following from the command line:
cd aerospike-server-enterprise-*sudo ./asinstall
For a description of files and directories that are installed, see Directory Structure.
Alternatively, you can install the Debian packages directly.
sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb
sudo dpkg -i aerospike-tools_version-distro_architecture.deb
sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb
sudo dpkg -i aerospike-tools_version-distro_architecture.deb
sudo rpm -Uvh aerospike-server-edition_version-1distro_architecture.deb
sudo rpm -Uvh aerospike-tools_version-distro_architecture.deb
Next steps
The Aerospike-included init script /etc/init.d/aerospike
manages the Aerospike Database Daemon /usr/bin/asd
.
In addition, the Aerospike database can be controlled with standard systemctl
commands. For details, see Aerospike Daemon Management.
Configure Aerospike
Installation establishes the server’s default configuration. An in-memory test namespace is configured by default. See Configure Aerospike Database to modify and tune the configuration.
Add devices and more
To add SSDs, make sure to read about setup and initialization.
Configure EE feature-key file
Since Database 6.1 the feature-key file for a single-node cluster is provided, so the server will start up automatically.
Configure logging
To configure logging for the Aerospike database, refer to Configuring Log Files.