CINXE.COM
rustup.rs - The Rust toolchain installer
<!DOCTYPE html> <head> <meta charset="utf-8"> <title>rustup.rs - The Rust toolchain installer</title> <meta name="keywords" content="Rust, Rust programming language, rustlang, rust-lang, Mozilla Rust, rustup"> <meta name="description" content="The Rust toolchain installer"> <link rel="stylesheet" href="normalize.css"> <link rel="stylesheet" href="rustup.css"> <link rel="icon" type="image/png" sizes="32x32" href="https://www.rust-lang.org/static/images/favicon-32x32.png"> <link rel="icon" type="image/svg+xml" href="https://www.rust-lang.org/static/images/favicon.svg"> <link rel="mask-icon" href="https://www.rust-lang.org/static/images/safari-pinned-tab.svg" color="#000"> </head> <body id="idx"> <main> <header> <div> <h1>rustup</h1> <h2>An installer for the systems programming language <a href="https://www.rust-lang.org">Rust</a></h2> </div> </header> <a id="platform-button" class="display-none" href="#"> click or press "n" to cycle platforms </a> <div id="platform-instructions-unix" class="instructions display-none"> <p>Run the following in your terminal, then follow the onscreen instructions.</p> <div class="copy-container"> <pre class="rustup-command">curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh</pre> <button id="copy-button-unix" class="copy-button" title="Copy curl command to clipboard to download Rustup" type="button"> <div class="copy-icon"> <svg width="24" height="25" viewBox="0 0 24 25" xmlns="http://www.w3.org/2000/svg" alt="Copy curl command to clipboard to download Rustup"> <path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"></path><path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"></path> </svg> </div> <div id="copy-status-message-unix" class="copy-button-text">Copied!</div> </button> </div> <p class="other-platforms-help">You appear to be running Unix. If not, <a class="default-platform-button" href="#">display all supported installers</a>.</p> </div> <div id="platform-instructions-win32" class="instructions display-none"> <p> To install Rust, download and run <a class="windows-download" href="https://win.rustup.rs/i686">rustup‑init.exe</a> then follow the onscreen instructions. </p> <p>You may also need the <a href="https://rust-lang.github.io/rustup/installation/windows-msvc.html">Visual Studio prerequisites</a>.</p> <hr/> <p>If you're a Windows Subsystem for Linux user run the following in your terminal, then follow the onscreen instructions to install Rust.</p> <div class="copy-container"> <pre class="rustup-command">curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh</pre> <button id="copy-button-win32" class="copy-button" title="Copy curl command to clipboard to download Rustup" type="button"> <div class="copy-icon"> <svg width="24" height="25" viewBox="0 0 24 25" xmlns="http://www.w3.org/2000/svg" alt="Copy curl command to clipboard to download Rustup"> <path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"></path><path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"></path> </svg> </div> <div id="copy-status-message-win32" class="copy-button-text">Copied!</div> </button> </div> <p class="other-platforms-help">You appear to be running Windows 32-bit. If not, <a class="default-platform-button" href="#">display all supported installers</a>.</p> </div> <div id="platform-instructions-win64" class="instructions display-none"> <p> To install Rust, download and run <a class="windows-download" href="https://win.rustup.rs/x86_64">rustup‑init.exe</a> then follow the onscreen instructions. </p> <p>You may also need the <a href="https://rust-lang.github.io/rustup/installation/windows-msvc.html">Visual Studio prerequisites</a>.</p> <hr/> <p>If you're a Windows Subsystem for Linux user run the following in your terminal, then follow the onscreen instructions to install Rust.</p> <div class="copy-container"> <pre class="rustup-command">curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh</pre> <button id="copy-button-win64" class="copy-button" title="Copy curl command to clipboard to download Rustup" type="button"> <div class="copy-icon"> <svg width="24" height="25" viewBox="0 0 24 25" xmlns="http://www.w3.org/2000/svg" alt="Copy curl command to clipboard to download Rustup"> <path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"></path><path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"></path> </svg> </div> <div id="copy-status-message-win64" class="copy-button-text">Copied!</div> </button> </div> <p class="other-platforms-help">You appear to be running Windows 64-bit. If not, <a class="default-platform-button" href="#">display all supported installers</a>.</p> </div> <div id="platform-instructions-win-arm64" class="instructions display-none"> <p> To install Rust, download and run <a class="windows-download" href="https://win.rustup.rs/aarch64">rustup‑init.exe</a> then follow the onscreen instructions. </p> <p>You may also need the <a href="https://rust-lang.github.io/rustup/installation/windows-msvc.html">Visual Studio prerequisites</a>.</p> <hr/> <p>If you're a Windows Subsystem for Linux user run the following in your terminal, then follow the onscreen instructions to install Rust.</p> <div class="copy-container"> <pre class="rustup-command">curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh</pre> <button id="copy-button-win-arm64" class="copy-button" title="Copy curl command to clipboard to download Rustup" type="button"> <div class="copy-icon"> <svg width="24" height="25" viewBox="0 0 24 25" xmlns="http://www.w3.org/2000/svg" alt="Copy curl command to clipboard to download Rustup"> <path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"></path><path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"></path> </svg> </div> <div id="copy-status-message-win-arm64" class="copy-button-text">Copied!</div> </button> </div> <p class="other-platforms-help">You appear to be running Windows on Arm. If not, <a class="default-platform-button" href="#">display all supported installers</a>.</p> </div> <div id="platform-instructions-unknown" class="instructions display-none"> <!-- unrecognized platform: ask for help --> <p>I don't recognize your platform.</p> <p> rustup runs on Windows, Linux, macOS, FreeBSD, NetBSD, and illumos. If you are on one of these platforms and are seeing this then please <a href="https://github.com/rust-lang/rustup/issues/new">report an issue</a>, along with the following values: </p> <div> <div>navigator.platform:</div> <div id="nav-plat"></div> <div>navigator.appVersion:</div> <div id="nav-app"></div> </div> <!-- duplicate the default cross-platform instructions --> <p>If you are running Unix,<br/>run the following in your terminal, then follow the onscreen instructions.</p> <div class="copy-container"> <pre class="rustup-command">curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh</pre> <button id="copy-button-unknown" class="copy-button" title="Copy curl command to clipboard to download Rustup" type="button"> <div class="copy-icon"> <svg width="24" height="25" viewBox="0 0 24 25" xmlns="http://www.w3.org/2000/svg" alt="Copy curl command to clipboard to download Rustup"> <path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"></path><path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"></path> </svg> </div> <div id="copy-status-message-unknown" class="copy-button-text">Copied!</div> </button> </div> <hr/> <div> <p> If you are running Windows 64-bit,<br/>download and run <a class="windows-download" href="https://win.rustup.rs/x86_64">rustup‑init.exe</a> then follow the onscreen instructions. </p> </div> <hr/> <div> <p> If you are running Windows on Arm,<br/>download and run <a class="windows-download" href="https://win.rustup.rs/aarch64">rustup‑init.exe</a> then follow the onscreen instructions. </p> </div> <hr/> <div> <p> If you are running Windows 32-bit,<br/>download and run <a class="windows-download" href="https://win.rustup.rs/i686">rustup‑init.exe</a> then follow the onscreen instructions. </p> </div> </div> <div id="platform-instructions-default" class="instructions"> <p>To install Rust, if you are running Unix,<br/>run the following in your terminal, then follow the onscreen instructions.</p> <div class="copy-container"> <pre class="rustup-command">curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh</pre> <button id="copy-button-default" class="copy-button" title="Copy curl command to clipboard to download Rustup" type="button"> <div class="copy-icon"> <svg width="24" height="25" viewBox="0 0 24 25" xmlns="http://www.w3.org/2000/svg" alt="Copy curl command to clipboard to download Rustup"> <path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"></path><path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"></path> </svg> </div> <div id="copy-status-message-default" class="copy-button-text">Copied!</div> </button> </div> <hr/> <div> <p> If you are running Windows 64-bit,<br/>download and run <a class="windows-download" href="https://win.rustup.rs/x86_64">rustup‑init.exe</a> then follow the onscreen instructions. </p> </div> <hr/> <div> <p> If you are running Windows on Arm,<br/>download and run <a class="windows-download" href="https://win.rustup.rs/aarch64">rustup‑init.exe</a> then follow the onscreen instructions. </p> </div> <hr/> <div> <p> If you are running Windows 32-bit,<br/>download and run <a class="windows-download" href="https://win.rustup.rs/i686">rustup‑init.exe</a> then follow the onscreen instructions. </p> </div> </div> <p id="help"> Need help?<br>Ask on <a href="https://discord.gg/rust-lang">#beginners in the Rust Discord</a><br> or in the <a href="https://users.rust-lang.org">Rust Users Forum</a>. </p> <p id="about"> <img src="https://www.rust-lang.org/logos/rust-logo-blk.svg" alt="" /> rustup is an official Rust project. <br/> <a href="https://rust-lang.github.io/rustup/installation/other.html">other installation options</a> · <a href="https://rust-lang.github.io/rustup-components-history/">component availability</a> · <a href="https://rust-lang.github.io/rustup/">about rustup</a> </p> </main> <script src="rustup.js"></script> </body>