Installing Rust with Rustup

Installing Rustup

Rustup is the official way to install and manage Rust versions. On Linux and macOS, you run a single shell command that downloads and runs the rustup installer, which then installs the rustc compiler, the cargo build tool, and the standard library.

Note: After the installer finishes, open a new terminal or run source $HOME/.cargo/env so the new commands are on your PATH.

Example: Installing Rustup

# Linux/macOS
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Windows
# Download and run rustup-init.exe from https://rustup.rs

Checking the Installed Version

Once installed, you can confirm Rust is ready by asking the compiler and the Cargo build tool for their version numbers. This is the fastest way to verify the install worked before writing any code.

Example: Checking the Installed Version

rustc --version
cargo --version

Updating Rust

Rust ships new stable releases roughly every six weeks. rustup update fetches the latest stable toolchain so you always have current compiler features and standard library additions.

Example: Updating Rust

rustup update stable

Confirming From Inside a Program

You can also verify your toolchain works end-to-end by compiling and running an actual Rust program. If it prints correctly, your installation is complete and functional.

Example: Confirming From Inside a Program

fn main() {
    println!("Rust toolchain is installed and working!");
}