anza-xyz-agave/docs/src/cli/install.md

---

title: Install the Solana CLI pagination_label: Install the Solana CLI sidebar_label: Installation

sidebar_position: 1

There are multiple ways to install the Solana tools on your computer depending on your preferred workflow:

• Use the Solana Install Tool (Simplest option)
• Download Prebuilt Binaries
• Build from Source
• Use Homebrew

Use The Solana Install Tool

MacOS & Linux

• Open your favorite Terminal application

• Install the Agave release LATEST_AGAVE_RELEASE_VERSION on your machine by running:

  sh -c "$(curl -sSfL https://release.anza.xyz/LATEST_AGAVE_RELEASE_VERSION/install)"
  

• You can replace LATEST_AGAVE_RELEASE_VERSION with the release tag matching the software version of your desired release, or use one of the three symbolic channel names: stable, beta, or edge.

• The following output indicates a successful update:

  downloading LATEST_AGAVE_RELEASE_VERSION installer
  Configuration: /home/solana/.config/solana/install/config.yml
  Active release directory: /home/solana/.local/share/solana/install/active_release
  * Release version: LATEST_AGAVE_RELEASE_VERSION
  * Release URL: https://github.com/anza-xyz/agave/releases/download/LATEST_AGAVE_RELEASE_VERSION/solana-release-x86_64-unknown-linux-gnu.tar.bz2
  Update successful
  

• Depending on your system, the end of the installer messaging may prompt you to

  Please update your PATH environment variable to include the solana programs:
  

• If you get the above message, copy and paste the recommended command below it to update PATH

• Confirm you have the desired version of solana installed by running:

  solana --version
  

• After a successful install, agave-install update may be used to easily update the Solana software to a newer version at any time.

---

Windows

• Open a Command Prompt (cmd.exe) as an Administrator

  • Search for Command Prompt in the Windows search bar. When the Command Prompt app appears, right-click and select “Open as Administrator”. If you are prompted by a pop-up window asking “Do you want to allow this app to make changes to your device?”, click Yes.

• Copy and paste the following command, then press Enter to download the Solana installer into a temporary directory:

  cmd /c "curl https://release.anza.xyz/LATEST_AGAVE_RELEASE_VERSION/agave-install-init-x86_64-pc-windows-msvc.exe --output C:\agave-install-tmp\agave-install-init.exe --create-dirs"
  

• Copy and paste the following command, then press Enter to install the latest version of Solana. If you see a security pop-up by your system, please select to allow the program to run.

  C:\agave-install-tmp\agave-install-init.exe LATEST_AGAVE_RELEASE_VERSION
  

• When the installer is finished, press Enter.

• Close the command prompt window and re-open a new command prompt window as a normal user

  • Search for "Command Prompt" in the search bar, then left click on the Command Prompt app icon, no need to run as Administrator)

• Confirm you have the desired version of solana installed by entering:

  solana --version
  

• After a successful install, agave-install update may be used to easily update the Solana software to a newer version at any time.

Download Prebuilt Binaries

If you would rather not use agave-install to manage the install, you can manually download and install the binaries.

Linux

Download the binaries by navigating to https://github.com/anza-xyz/agave/releases/latest, download solana-release-x86_64-unknown-linux-gnu.tar.bz2, then extract the archive:

tar jxf solana-release-x86_64-unknown-linux-gnu.tar.bz2
cd solana-release/
export PATH=$PWD/bin:$PATH

MacOS

Download the binaries by navigating to https://github.com/anza-xyz/agave/releases/latest, download solana-release-x86_64-apple-darwin.tar.bz2, then extract the archive:

tar jxf solana-release-x86_64-apple-darwin.tar.bz2
cd solana-release/
export PATH=$PWD/bin:$PATH

Windows

• Download the binaries by navigating to https://github.com/anza-xyz/agave/releases/latest, download solana-release-x86_64-pc-windows-msvc.tar.bz2, then extract the archive using WinZip or similar.

• Open a Command Prompt and navigate to the directory into which you extracted the binaries and run:

  cd solana-release/
  set PATH=%cd%/bin;%PATH%
  

Build From Source

If you are unable to use the prebuilt binaries or prefer to build it yourself from source, follow these steps, ensuring you have the necessary prerequisites installed on your system.

Prerequisites

Before building from source, make sure to install the following prerequisites:

Rust

For all platforms, check "Install Rust" at https://www.rust-lang.org/tools/install for the latest installation instructions.

For Debian and Other Linux Distributions:

Install build dependencies:

• Build essential
• Package config
• Udev & LLM & libclang

• Protocol buffers

  apt-get install \
  build-essential \
  pkg-config \
  libudev-dev llvm libclang-dev \
  protobuf-compiler
  

For Other Linux Distributions:

Replace apt with your distribution's package manager (e.g., yum, dnf, pacman) and adjust package names as needed.

For macOS:

Check "Install Homebrew" at https://brew.sh/ for the latest installation instruction for Homebrew if not already installed.

Then, install build dependencies with brew:

brew install pkg-config libudev protobuf llvm coreutils

Follow the instructions given at the end of the brew install command about PATH configurations.

For Windows:

• Download and install the Build Tools for Visual Studio (2019 or later) from the Visual Studio downloads page. Make sure to include the C++ build tools in the installation.
• Install LLVM: Download and install LLVM from the official LLVM download page.
• Install Protocol Buffers Compiler (protoc): Download protoc from the GitHub releases page of Protocol Buffers, and add it to your PATH.

:::info

Users on Windows 10 or 11 may need to install Windows Subsystem for Linux (WSL) in order to be able to build from source. WSL provides a Linux environment that runs inside your existing Windows installation. You can then run regular Linux software, including the Linux versions of Solana CLI.

After installed, run wsl from your Windows terminal, then continue through the Debian and Other Linux Distributions above.

:::

Building from Source

After installing the prerequisites, proceed with building Solana from source, navigate to the Agave GitHub releases page, and download the Source Code archive. Extract the code and build the binaries with:

./scripts/cargo-install-all.sh .
export PATH=$PWD/bin:$PATH

Use Homebrew

This option requires you to have Homebrew package manager on your MacOS or Linux machine.

MacOS & Linux

• Follow instructions at: https://formulae.brew.sh/formula/solana

Homebrew formulae is updated after each solana release, however it is possible that the Homebrew version is outdated.

• Confirm you have the desired version of solana installed by entering:

  solana --version