install-sui.md

description	Install the Sui binary and Move compiler using suiup, Homebrew, or Chocolatey to start developing Move smart contracts.

Install Sui

Move is a compiled language, so you need to install a compiler to be able to write and run Move programs. The compiler is included into the Sui binary, which can be installed or downloaded using one of the methods below.

Installing via suiup

The best way to install Sui is by using suiup. It provides a simple way to install binaries and to manage different versions of binaries for different environments (e.g. testnet and mainnet).

Installation instructions for suiup can be found in the repository README.

To install Sui, run the following command:

suiup install sui

Download Binary

You can download the latest Sui binary from the releases page. The binary is available for macOS, Linux and Windows. For education purposes and development, we recommend using the mainnet version.

Install Using Homebrew (MacOS)

You can install Sui using the Homebrew package manager.

brew install sui

Install Using Chocolatey (Windows)

You can install Sui using the Chocolatey package manager for Windows.

choco install sui

Build Using Cargo (MacOS, Linux)

You can install and build Sui locally by using the Cargo package manager (requires Rust)

cargo install --git https://github.com/MystenLabs/sui.git sui --branch mainnet

Change the branch target here to testnet or devnet if you are targeting one of those.

Make sure that your system has the latest Rust versions with the command below.

rustup update stable

Troubleshooting

For troubleshooting the installation process, please refer to the Install Sui Guide.