Install tools on macOS

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

This page describes how to install Aerospike Tools on macOS using .pkg installers from the Aerospike download site or artifact repository.

Prerequisites

Before proceeding, verify that your system meets the prerequisites described in Tools requirements.

Install a per-tool `.pkg` from the artifact repository

Individual tools are published as macOS .pkg installers on the Aerospike artifact repository (https://artifact.aerospike.io). Download the .pkg for the tool and architecture you need from the repository UI or your organization’s release process, then run the installer.

After installation, verify with asadm --version or the equivalent for the tool you installed.

For Linux hosts, use Install tools on Linux with a package manager.

Download the package (legacy download page)

Go to the tools download page to get legacy bundled installers for macOS.

Select the tools version you want to install.
Select the CPU architecture of the system where you want to install tools.
Select the macOS option from System, according to the selected CPU architecture.
Click Download.

Forget the previously installed tools

If you have an existing installation of Aerospike tools, you might need to forget the previously installed version to avoid potential conflicts with the new version.

Run the following command see which version of tools is currently installed:
Terminal window
```
pkgutil --pkgs | grep 'aerospike.tools'
```
Run the following command to forget the previous installations. Replace VERSION with the tools package version returned in the previous command.
Terminal window
```
sudo pkgutil --forget com.aerospike.tools.VERSION
```

Install Aerospike tools

Locate the downloaded .pkg installer.
Double-click the installer and follow the steps in the installation wizard.

Verify installation

Run the following command to verify the package installation.

pkgutil --pkgs | grep 'aerospike.tools'