---
title: "Install tools on macOS"
description: "Learn how to install Aerospike tools on macOS, manage previous versions, and verify tools like asadm and aql."
---

# Install tools on macOS

> For the complete documentation index see: [llms.txt](https://aerospike.com/docs/llms.txt)
> 
> All documentation pages available in markdown.

This page describes how to install Aerospike Tools on macOS.

## Prerequisites

Before proceeding, verify that your system meets the prerequisites described in [Tools requirements](https://aerospike.com/docs/database/tools/install/requirements).

## Download the package

Go to the [tools download page](https://aerospike.com/download/tools/) to get installers for macOS.

1.  Select the tools version you want to install.
    
2.  Select the CPU architecture of the system where you want to install tools.
    
3.  Select the **macOS** option from **System**, according to the selected CPU architecture.
    
4.  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.

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

## Install Aerospike tools

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

## Verify installation

Run the following command to verify the package installation.

Terminal window

```bash
pkgutil --pkgs | grep 'aerospike.tools'
```

::: tip
To verify a specific tool, run it with the `--version` flag. For example, `asadm --version`. If security is enabled on your cluster, provide a valid username and password.
:::