Install Specific Aptos CLI Versions (Advanced)

Using existing releases

Using the Aptos CLI script

If you are already using the installation script for Mac and Linux, you can install a specific version of the Aptos CLI using the following command:

curl -fsSL "https://aptos.dev/scripts/install_cli.sh" | sh -s -- --cli-version 7.9.0

Using asdf

If you are already using asdf, you can install a specific version of the Aptos CLI using the following command:

asdf install aptos 7.9.0

Using mise

If you are already using mise, you can install a specific version of the Aptos CLI using the following command:

mise install aptos@7.9.0

Installation from source code

Note

This guide is for advanced users who need to build and install a specific version of the Aptos CLI.

If you are looking to install a specific version of the Aptos CLI, we suggest you use ASDF or Mise to handle it for you.

If you need a specific version of the Aptos CLI, you can build it directly from the Aptos source code. This installation method is primarily used to interact with specific features on Devnet which may not have made it to Testnet / Mainnet yet. You may also want to follow these steps if you are running an architecture which does not play well with the existing releases / pre-compiled binaries.

If you do not need this advanced method, you can find the normal install steps here.

Install on macOS / Linux

1. Checkout the Aptos source code.

   git clone https://github.com/aptos-labs/aptos-core.git

2. Ensure you have cargo installed.

3. Build the Aptos CLI:

   cargo build --package aptos --profile cli

   The binary will be available at target/cli/aptos.

4. (Optional) Move this executable to a place in your PATH.

5. Verify the installation worked.

   target/cli/aptos help

   These help instructions also serve as a useful detailed guide for specific commands.

Install on Windows

1. Checkout the Aptos source code.

   git clone https://github.com/aptos-labs/aptos-core.git

2. Ensure you have cargo installed.

3. Build the Aptos CLI.

   cargo build --package aptos --profile cli

   The binary will be available at target\cli\aptos.exe.

4. (Optional) Move this executable to a place in your PATH.

5. Verify the installation worked.

   target\cli\aptos.exe help

   These help instructions also serve as a useful detailed guide for specific commands.