Skip to main content
This guide walks you through installing and configuring the necessary tools to start developing on Sui.

Prerequisites

Before you begin, ensure you have:
  • A modern operating system (macOS, Linux, or Windows with WSL2)
  • At least 8GB of RAM
  • 10GB of free disk space

Install Sui CLI

The Sui CLI is the primary tool for interacting with the Sui network and developing Move packages.

Configure Network Connection

Sui supports multiple networks: localnet, devnet, testnet, and mainnet.

View active environment

Switch to testnet

Get testnet tokens

Request test SUI tokens from the faucet:

Check your address and balance

Install Development Tools

VS Code Extension

For the best Move development experience, install the Move Analyzer extension:
  1. Open VS Code
  2. Go to Extensions (Cmd/Ctrl + Shift + X)
  3. Search for “Move” and install the Move Analyzer extension

Git

Ensure Git is installed for version control:
If not installed, download from git-scm.com.

Set Up Local Network (Optional)

For local development and testing, you can run a local Sui network:

Verify Your Setup

Create a simple test to verify everything works:

Next Steps

Now that your environment is set up:

Troubleshooting

Rust toolchain issues

If you encounter Rust version issues:

Network connectivity

If you can’t connect to a network, verify the RPC endpoint:

Permission errors

On Linux/macOS, you may need to add Cargo’s bin directory to your PATH:
Add this line to your ~/.bashrc or ~/.zshrc to make it permanent.