Skip to main content

Fix Rust installation

When encountering issues with your Rust installation, we recommend a cleanup (uninstall) first, especially if you have multiple installations (by accident or on purpose).

Uninstall existing Rust

If you've installed Rust using your OS package manager:

# Ubuntu
sudo apt remove cargo
sudo apt remove rustc
sudo apt autoremove

If you've installed Rust using rustup:

rustup self uninstall

If you've installed Rust using brew:

brew uninstall rust
note

We never recommend installing Rust using brew, especially because it makes it non-trivial to switch between different Rust versions.

If you've installed Rust using snap:

snap remove rustup

If you've installed Rust using mxpy with a version older than v9:

rm -rf ~/multiversx-sdk/vendor-rust

If you've installed Rust using mxpy v9 or later:

rustup self uninstall

Reinstall Toolchain Setup

After successfully uninstalling your current toolchain, you can follow the setup guide to reinstall the environment from scratch.