Skip to main content

Install using Binary Package


Use this tutorial to install Aerospike on any Linux system with glibc 2.11 or newer. glibc 2.11 was released in January, 2009 and most modern Linux distributions - Debian 6+, Centos 6+, OpenSUSE 12+, Ubuntu 10.04+ support this this version.

This package contains an Aerospike binary that can be run in a user directory without installing software, and does not require root privileges.

For Aerospike Server 5.1 and later, libcurl is required#

For Aerospike Server 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#

Download Aerospike Server Community Edition#

To download the latest stable release, run the following:

wget -O aerospike.tgz ''

For release notes and details on releases, visit the Download page.

Install Aerospike#

Extract the contents of the package#

To extract the contents of the package, run the following:

tar -xvf aerospike.tgz && cd aerospike-server

Initialize Aerospike Server#

Next, we will need to initialize a directory to host an Aerospike instance:

./bin/aerospike init --help # to see the initialization options./bin/aerospike init

After a directory is initialized to host an Aerospike instance, it contains the following files and subdirectories.

./bin/aerospikeThe script to manage this instance.
./bin/asdThe Aerospike server daemon, asd.
./etc/aerospike.confThe configuration file for this instance.
./share/Read-only files used by this instance.
./var/Runtime files created by asd, including logs and data files.

Install Aerospike Tools#

Superuser privileges (sudo) may be required to install Aerospike tools.

To install the tools, download one of the following packages:

# Red Hat Variants (RHEL7):wget -O aerospike-tools.tgz ''# Debian 8:wget -O aerospike-tools.tgz ''# Debian 9:wget -O aerospike-tools.tgz ''# Debian 10:wget -O aerospike-tools.tgz ''# Ubuntu 18.04 LTS:wget -O aerospike-tools.tgz ''# Ubuntu 20.04 LTS:wget -O aerospike-tools.tgz ''

Decompress the .tgz file and then install the tools package:

    tar -xvf aerospike-tools.tgz && cd aerospike-tools-*    # Red Hat Variants (RHEL7):    rpm -Uvh aerospike-tools-*.el7.x86_64.rpm    # Red Hat Variants (RHEL8):    rpm -Uvh aerospike-tools-*.el8.x86_64.rpm    # Debian 8:    dpkg -i aerospike-tools-*.debian8.x86_64.deb    # Debian 9:    dpkg -i aerospike-tools-*.debian9.x86_64.deb        # Debian 10:    dpkg -i aerospike-tools-*.debian10.x86_64.deb        # Ubuntu 18.04 LTS:    dpkg -i aerospike-tools-*.ubuntu18.04.x86_64.deb    # Ubuntu 20.04 LTS:    dpkg -i aerospike-tools-*.ubuntu20.04.x86_64.deb

This installation adds tools under /opt/aerospike/bin and links them from /usr/bin.

Run Aerospike#

Aerospike includes an init script for running the server, located in ./bin/aerospike. This script will manage the Aerospike Server Daemon (asd) located in ./bin.


The aerospike instance will store log files in ./var/log and system data in ./share. If you change the user for the Aerospike process, then you will need to ensure the user has permissions for ./var/log and ./share.

Start Aerospike#

You can start asd by running:

sudo ./bin/aerospike start

Verify Aerospike is Running#

You can verify whether asd had started successfully by checking the status:

./bin/aerospike status# info: process running

You can also search the server log at ./var/log/aerospike.log for the successful startup message:

grep cake /var/log/aerospike/aerospike.log

You should see:

Jun 22 2014 03:35:33 GMT: INFO (as): (as.c::376) service ready: soon there will be cake!

If there are errors during start up, consult the Troubleshooting guide.

Next Steps#


Make sure NTP is set up, especially if the node will be operating in a multi-node cluster. A guide to installing NTP can be found in this knowledge base article.

Verify the server was installed correctly.

Start developing!