5.2 KiB
title |
---|
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 LATEST_SOLANA_RELEASE_VERSION on your machine by running:
curl -sSf https://raw.githubusercontent.com/solana-labs/solana/LATEST_SOLANA_RELEASE_VERSION/install/solana-install-init.sh | sh -s - LATEST_SOLANA_RELEASE_VERSION
-
If you are connecting to a different testnet, you can replace
LATEST_SOLANA_RELEASE_VERSION
with the release tag matching the software version of your desired testnet, or replace it with the named channelstable
,beta
, oredge
. -
The following output indicates a successful update:
looking for latest release
downloading LATEST_SOLANA_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_SOLANA_RELEASE_VERSION
* Release URL: https://github.com/solana-labs/solana/releases/download/LATEST_SOLANA_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,
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:
curl http://release.solana.com/LATEST_SOLANA_RELEASE_VERSION/solana-install-init-x86_64-pc-windows-gnu.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 LATEST_SOLANA_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,
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-gnu.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