Zum Hauptinhalt springen

Install the Solana Tool Suite

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

Use Solana's Install Tool​

MacOS & Linux​

  • Open your favorite Terminal application

  • Install the Solana release v1.17.7 on your machine by running:

sh -c "$(curl -sSfL https://release.solana.com/v1.17.7/install)"

  • You can replace v1.17.7 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 v1.17.7 installer
Configuration: /home/solana/.config/solana/install/config.yml
Active release directory: /home/solana/.local/share/solana/install/active_release
* Release version: v1.17.7
* Release URL: https://github.com/solana-labs/solana/releases/download/v1.17.7/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, solana-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.solana.com/v1.17.7/solana-install-init-x86_64-pc-windows-msvc.exe --output C:\solana-install-tmp\solana-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:\solana-install-tmp\solana-install-init.exe v1.17.7

  • 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, solana-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 solana-install to manage the install, you can manually download and install the binaries.

Linux​

Download the binaries by navigating to https://github.com/solana-labs/solana/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/solana-labs/solana/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/solana-labs/solana/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, navigate to https://github.com/solana-labs/solana/releases/latest, and download the Source Code archive. Extract the code and build the binaries with:

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

You can then run the following command to obtain the same result as with prebuilt binaries:

solana-install init

Use Homebrew​

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

MacOS & Linux​

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