Skip to content

Install tools on Linux with a package manager

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

Configure APT, DNF, or YUM on your Linux host to use Aerospike’s public package repository once, then install only the command-line tools you need. Tool package versions on the repository are independent of Aerospike Database server releases.

Applies to

  • Product: Aerospike tools distributed as individual Linux packages on the public Aerospike artifact repository
  • Package managers: APT (Debian, Ubuntu), DNF or YUM (RHEL, Rocky Linux, AlmaLinux, Amazon Linux 2023)
  • Architectures: amd64 / x86_64, arm64 / aarch64
  • Not covered here: Legacy tools tarball installs — see Install tools on Linux from an archive

For supported distributions, see Aerospike tools requirements and Platform support.

Prerequisites

  • Root access or permission to run sudo
  • A supported Linux distribution for your architecture
  • Outbound HTTPS access to https://artifact.aerospike.io
  • On Debian/Ubuntu: wget, gpg, and ca-certificates (install with sudo apt-get install -y wget gpg ca-certificates if missing)

Import the GPG key

Aerospike signs packages with one public GPG key. Import it once before adding a repository:

Terminal window
wget -qO - https://artifact.aerospike.io/artifactory/api/security/keypair/aerospike/public \
  | sudo gpg --dearmor -o /usr/share/keyrings/aerospike.gpg

Aerospike uses the same key in two forms: APT references the dearmored binary file via signed-by=, while DNF and YUM reference the ASCII-armored key URL directly via gpgkey=.

Configure the repository

Base: https://artifact.aerospike.io/artifactory/deb

  1. Set distribution and architecture variables:

    Terminal window
    . /etc/os-release
    CODENAME=$VERSION_CODENAME
    ARCH=$(dpkg --print-architecture)
    KEYRING=/usr/share/keyrings/aerospike.gpg
    REPO_URL="https://artifact.aerospike.io/artifactory/deb"

  2. Add the Aerospike repository:

    Terminal window
    cat <<EOF | sudo tee /etc/apt/sources.list.d/aerospike.list
    deb [arch=$ARCH signed-by=$KEYRING] $REPO_URL $CODENAME main
    EOF

  3. Refresh package indexes:

    Terminal window
    sudo apt-get update

Install individual tools

Install one package per tool. Package names follow the aerospike-<tool> pattern (for example, aerospike-asadm). Useful when you want to select a minimum set of tools, as opposed to the prepackaged bundle provided by the aerospike-tools package.

ToolDEB / RPM package nameDocumentation
Aerospike Admin (asadm), Aerospike Info (asinfo)aerospike-asadmasadm
Aerospike Quick Look (aql)aerospike-aqlAQL
Aerospike Benchmark (asbench)aerospike-asbenchasbench
Aerospike Configuration (asconfig)aerospike-asconfigasconfig
Legacy Aerospike Backup & Restore (asbackup, asrestore)aerospike-asbackupasbackup

Example: install asadm and asinfo, both of which ship in aerospike-asadm:

Terminal window
sudo apt-get install aerospike-asadm

Install the tools package

You can install the aerospike-tools bundle of tools containing asadm, asinfo, aql, asconfig, asbench, asbackup/asrestore.

Terminal window
sudo apt-get install aerospike-tools

List available versions

Terminal window
sudo apt-get update
apt list -a aerospike-asadm

Replace aerospike-asadm with any package name from the table above.

Install a specific version

Terminal window
sudo apt-get install aerospike-asadm=5.0.3-5ubuntu24.04

Use the exact version string from apt list -a. DEB revisions embed the distribution, so the string differs between Ubuntu and Debian releases.

Install the latest version in a version lineage

Individual tool packages use a three-component SemVer version, followed by a package iteration and a distribution token: 5.0.3-5ubuntu24.04 on DEB and 5.0.3-5.el9 on RPM. Each tool versions independently of the others and of the aerospike-tools bundle version.

To install the newest package matching a prefix (for example, all 5.0.x builds), set LINEAGE and select the highest match with sort -V.

Terminal window
LINEAGE=5.0
PKG=aerospike-asadm


VERSION=$(apt list -a "$PKG" 2>/dev/null \
  | awk -v pkg="$PKG" '$1 ~ "^" pkg "/" {print $2}' | grep "^${LINEAGE}\\." | sort -V | tail -1)
echo "Latest version in ${LINEAGE}.x lineage: $VERSION"
sudo apt-get install "${PKG}=${VERSION}"

Verify

  1. Confirm the package is registered:

    Terminal window
    dpkg-query -l 'aerospike-asadm'

  2. Confirm the binary runs (example for asadm):

    Terminal window
    asadm --version

    If security is enabled on your cluster, provide valid credentials when connecting to a live cluster.

Troubleshoot

SymptomCauseFix
unsupported from the RPM DIST scriptOS not in the public RPM layoutConfirm platform support; use tarball install if needed
GPG or signature errorsKey not imported or repo misconfiguredRe-run the GPG import and repository steps
Package not found after apt-get updateWrong CODENAME or architectureCheck VERSION_CODENAME in /etc/os-release and run dpkg --print-architecture; match supported OS list
dnf list fails on minimal imagesImage uses microdnfUse microdnf repoquery and microdnf install

Next steps