Skip to main content

Install on Ubuntu

These are the details on installing the Aerospike database on Ubuntu systems. For precise details on supported OSes, see Enterprise Downloads.

  • To install, you must have root access or permission to run sudo. As an alternative to root access, you can install the binary distribution.

Assumed skills

These instructions assume that you have the following skills or understanding:

  • Familiarity with the Linux operating system you are installing on.
  • Shell commands like wget or apt-get, tar, and editors.
  • TCP/IP networking.

Notational conventions

  • <aerospike_version>, is the version of the Aerospike database.
  • <ubuntu_version>, is the version number of the OS. The value can be ubuntu18, or ubuntu20.

Supported Ubuntu versions#

The Aerospike Database is supported on the following versions of Ubuntu:

  • Ubuntu 20.04
  • Ubuntu 18.04

For Aerospike Database 5.1 and later, libcurl is required#

For Aerospike Database 5.1 and later, be sure to install the proper version of libcurl. For details, see Required - libcurl version for your Linux operating system.

Download Aerospike Database#

To download Aerospike Database, run one of the following commands:


If you do not have wget, use curl instead.

For Aerospike Enterprise Edition latest version, use one of these commands for the desired version of Ubuntu:

 # Get Aerospike Database for Ubuntu 20.04wget -O aerospike.tgz ''
 # Get Aerospike Database for Ubuntu 18.04wget -O aerospike.tgz ''

For version 4.5.x or earlier of the Aerospike Enterprise Edition, use the following command and your username and password:

wget -O aerospike.tgz '<ubuntu_version>' --user='userName' --password='<passWord>'

Extract the contents of 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 <ubuntu_version> is one of ubuntu20.04 or ubuntu18.04:


The directory includes:

  • license.txt — licenses for Aerospike and other software included in the package.
  • aerospike-tools-<aerospike_version>.<ubuntu_version>.x86_64.debAerospike command-line tools and utilities.
  • aerospike-server-enterprise-<aerospike_version>.<ubuntu_version>.x86_64.deb — the Aerospike database package.

Release Notes

For release notes and details on releases, see Download.

Install and configure Aerospike#

Install Aerospike Database and Tools#

You must install via the command line. Clicking a .deb package is not supported.

To install the server and the tools packages, run the following:

cd aerospike-server-enterprise-<aerospike_version>-<ubuntu_version>sudo ./asinstall

If installing Aerospike Database release versions 5.1.0.X and 5.2.0.X, and python2 is not installed, see the Python Package Dependency for .deb Installers article.

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

Problems during installation#

If there are errors during the installation, see Troubleshooting.

Configure Aerospike Database and default namespace#

Installation establishes the server's default configuration.

An in-memory namespace called test is configured by default.

Adding devices and more#

To add storage devices, configure a cluster, tune your configuration to your hardware, and other settings, see Configure Aerospike Database.

For Aerospike Enterprise Edition, install features.conf#

Enterprise Edition requires a feature-key file called features.conf that enables gated features, such as compression.


Enterprise Edition server version >= 4.6 will not start without this file.

See Configure the Feature Key File.

Configure logging#

To configure logging for the Aerospike database, see Configure - Log.

Start Aerospike Database#

The Aerospike-included init script /etc/init.d/aerospike manages the Aerospike Database Daemon /usr/bin/asd.

For later versions of Ubuntu, the Aerospike database can be controlled with standard systemctl commands. For details, see Aerospike systemd Daemon Management.

Problems during Startup#

If there are errors during start up, see Startup Problems.

Verify Aerospike Database is running#

For details on getting the status of the Aerospike database with systemctl, see Aerospike systemd Daemon Management.