Install Aerospike on Linux

This quickstart walks you through downloading, extracting, and installing Aerospike Database on Linux (Debian, Ubuntu, or RHEL). When you’re done, you’ll have Aerospike installed with an in-memory namespace, ready for development and testing.

Note

Mixed Linux distributions are supported within a cluster as long as each is an Aerospike-supported version. However, for consistent performance and easier debugging, we recommend using the same OS version for all nodes.

Requirements

Aerospike tools run on 64-bit Linux distributions, including Red Hat Enterprise Linux (RHEL) and its binary compatible variants, Ubuntu, Debian, Amazon Linux, and Oracle Linux. See Platform support and compatibility for more information.

Prerequisites

Caution

Aerospike Database is not supported on systems with SELinux in Enforcing mode. If you are using SELinux, it must be permanently disabled or permanently set to Permissive mode. See the RHEL documentation for more information.

Debian

• To install, you must have root access or permission to run sudo.
• Verify that you have the libcurl4 package installed.

Ubuntu

• To install, you must have root access or permission to run sudo.
• Verify that you have the libcurl4 package installed.

RHEL

• SELinux must be permanently disabled or permanently set to Permissive mode.
• To install, you must have root access or permission to run sudo.
• Verify that you have the libcurl or libcurl-minimal package installed.
• For RHEL 8 (Database 5.7.0+), “stripped-down” or non-standard OS versions must meet specific dependencies before installing Aerospike EE. See CentOS 8 package dependencies.
• Support for CentOS 7 was removed in Database 7.0.0. For CentOS, the Aerospike installation files are built with OpenSSL version 1.02. Aerospike will fail on earlier versions of OpenSSL.
• Starting with Database 8.1.1, OpenSSL version 1.1.0 or later is required.

Note

Some RHEL 7 and RHEL 8 variants for 64-bit ARM have changed their default kernels to a 64K memory page size, and are therefore no longer supported. Aerospike users with deployments on these operating system versions must upgrade to one whose kernel has a 4K page size. Amazon Linux 2 and Amazon Linux 2023 for 64-bit ARM are safe.

Install Aerospike Database

You can download the software from the download page, or download from the command line with the example URL in Step 1.

We recommend that you read the release notes of the version you download. To learn about automating downloads from the artifact repository, see the FAQ on downloads.

Aerospike Community, Enterprise, and Federal editions are available for all supported Linux distributions, and use the following naming convention: aerospike-server-EDITION_VERSION_tools-TOOLS-VERSION_DISTRO_ARCHITECTURE.tgz

1. Download Aerospike Database.

   Base URL:

   https://download.aerospike.com/artifacts/aerospike-server-edition/server-version/

   Example download command. The following command is an example only. Choose the edition and version from the artifact index and update the URL accordingly.

   wget -O aerospike-server.tgz "https://download.aerospike.com/artifacts/aerospike-server-enterprise/8.1.1/aerospike-server-enterprise_8.1.1.2_tools-12.1.1_ubuntu24.04_x86_64.tgz"

2. Extract the package.

   tar -xvf aerospike-server.tgz

   The contents are extracted to a directory named similarly to the package. The directory includes:

   • license.txt — licenses for Aerospike and other software included in the package
   • Tools package — Aerospike command-line tools and utilities
   • Server package — the Aerospike Database package

3. Install the server and tools. Run from the extracted directory:

   cd aerospike-server-enterprise-*
   sudo ./asinstall

   For a description of files and directories that are installed, see Directory structure.

Alternatively, install the Debian or RPM packages directly:

Debian

sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb

sudo dpkg -i aerospike-tools_version-distro_architecture.deb

Ubuntu

sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb

sudo dpkg -i aerospike-tools_version-distro_architecture.deb

RHEL

sudo rpm -Uvh aerospike-server-edition_version-1distro_architecture.rpm

sudo rpm -Uvh aerospike-tools_version-distro_architecture.rpm

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, see setup and initialization.

Configure EE feature-key file

Aerospike EE requires a feature-key file to start up and enable gated features, such as compression.

Note

Starting with Database 6.1.0, 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, see Log management.