The first step to using Rust is to install it. Generally speaking, you’ll need an Internet connection to run the commands in this chapter, as we’ll be downloading Rust from the internet.
We’ll be showing off a number of commands using a terminal, and those lines all
$. We don't need to type in the
$s, they are there to indicate
the start of each command. We’ll see many tutorials and examples around the web
that follow this convention:
$ for commands run as our regular user, and
for commands we should be running as an administrator.
Installing on Linux or Mac
If we're on Linux or a Mac, all we need to do is open a terminal and type this:
$ curl -sSf https://static.rust-lang.org/rustup.sh | sh
This will download a script, and stat the installation. If it all goes well, you’ll see this appear:
Welcome to Rust. This script will download the Rust compiler and its package manager, Cargo, and install them to /usr/local. You may install elsewhere by running this script with the --prefix=<path> option. The installer will run under ‘sudo’ and may ask you for your password. If you do not want the script to run ‘sudo’ then pass it the --disable-sudo flag. You may uninstall later by running /usr/local/lib/rustlib/uninstall.sh, or by running this script again with the --uninstall flag. Continue? (y/N)
From here, press
y for ‘yes’, and then follow the rest of the prompts.
Installing on Windows
If you're on Windows, please download the appropriate installer.
Uninstalling Rust is as easy as installing it. On Linux or Mac, just run the uninstall script:
$ sudo /usr/local/lib/rustlib/uninstall.sh
If we used the Windows installer, we can re-run the
.msi and it will give us
an uninstall option.
If we've got Rust installed, we can open up a shell, and type this:
$ rustc --version
You should see the version number, commit hash, and commit date.
If you do, Rust has been installed successfully! Congrats!
If you don't and you're on Windows, check that Rust is in your %PATH% system variable. If it isn't, run the installer again, select "Change" on the "Change, repair, or remove installation" page and ensure "Add to PATH" is checked.
If not, there are a number of places where we can get help. The easiest is the #rust IRC channel on irc.mozilla.org, which we can access through Mibbit. Click that link, and we'll be chatting with other Rustaceans (a silly nickname we call ourselves) who can help us out. Other great resources include the user’s forum, and Stack Overflow.
This installer also installs a copy of the documentation locally, so we can
read it offline. On UNIX systems,
/usr/local/share/doc/rust is the location.
On Windows, it's in a
share/doc directory, inside the directory to which Rust