Skip to content
Visit booth 3171 at Google Cloud Next to see how to unlock real-time decisions at scaleMore info

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 distributionlibcurl package name
Amazon Linux 2023libcurl
Debian 11libcurl4
Debian 12libcurl4
RHEL 8 (el8)libcurl
RHEL 8 (el8)libcurl-minimal
RHEL 9 (el9)libcurl
RHEL 9 (el9)libcurl-minimal
Ubuntu 20.04libcurl4
Ubuntu 22.04libcurl4
Ubuntu 24.04 LTSlibcurl4

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.

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
NameOptions
editioncommunity | enterprise | federal
server-version6.2.0.0, and so on
tools-version8.0.2 and later
distrodebian10 | debian11 | debian12
architectureamd64 | arm64

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:

Terminal window
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:

Install

To install the server and the tools packages, run the following from the command line:

Terminal window
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.

Terminal window
sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb
sudo dpkg -i 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.

Feedback

Was this page helpful?

What type of feedback are you giving?

What would you like us to know?

+Capture screenshot

Can we reach out to you?