What is SUIup

SuiUp is a tool (think of it like “rustup for Sui”) that lets you install and manage different versions of Sui-related CLI tools all in one place. That means you can handle the Sui CLI, the Move Package Registry CLI (MVR), and the Walrus CLI all from one convenient tool

Why Use SuiUp? 🧠

All-in-One Convenience: Instead of installing sui, mvr, and walrus separately (and trying to track each version), SuiUp handles it all for you. It allows easy installation and switching between versions of these CLIs — all in one place.

Better DevX (Developer Experience): SuiUp dramatically simplifies version management. Need to test your dApp on a new Sui testnet release but also maintain an older version for another project? No problem — you can install multiple versions side-by-side and switch with a single command.

Avoid PATH Conflicts: By managing binaries centrally, SuiUp helps prevent confusion around which version you're running. It installs default binaries in a dedicated directory (like ~/.local/bin on Mac/Linux) and warns you if that directory isn't in your PATH. Make sure that directory comes first in your PATH so it takes priority.

Consistency Across Environments: For teams and open-source projects, SuiUp lets everyone sync to the same CLI versions easily. No more "works on my machine" issues.

Quick Updates & Rollbacks: Upgrading or downgrading your CLI is as easy as one command. Try new releases with confidence — you can always switch back if needed.

Getting Started with SuiUp

Before using SuiUp, you need to install it on your system. SuiUp supports all major operating systems:

Install with Script:

curl -sSfL https://raw.githubusercontent.com/Mystenlabs/suiup/main/install.sh | sh

Or with Cargo:

cargo install --git https://github.com/Mystenlabs/suiup.git --locked

Key Commands: Installing

suiup install sui@testnet
suiup install sui@devnet
suiup install sui@testnet-1.40.1
suiup install mvr
suiup install mvr@0.0.8
suiup install walrus -y

Update installed tools:

suiup update sui@devnet

Set default version:

suiup default set sui@testnet-1.44.2
suiup default set mvr@0.0.7

Show current version in use:

suiup default get

List available binaries:

suiup list

Bonus: Install from Nightly or Branch (Advanced Users Only)

suiup install mvr --nightly
suiup install mvr --nightly my_branch
suiup install mvr --nightly --debug

Troubleshooting 🚫

If suiup is not found → check your PATH

If the wrong version is being used → ensure .local/bin is first in PATH

Use which sui and suiup which to debug