---
title: "1. Installing Scrypto"
path: "/developers/getting-started/01-install-scrypto"
version: "1.4.1"
author: "Hydrate"
createdAt: "2026-02-22T17:37:35.545Z"
updatedAt: "2026-07-27T17:54:26.106Z"
---

# 1. Installing Scrypto

## Overview

Scrypto is Radix's smart-contract language, built on Rust. You need three things: the Rust toolchain, the [WebAssembly](https://webassembly.org) compilation target, and the Radix CLI tools.

## Fastest Path: VS Code Dev Container

If you would rather not install a Rust toolchain at all, the official [Scrypto Starter](https://github.com/radixdlt/scrypto-starter) repository ships a pre-configured VS Code Dev Container with everything below already in place. This is the fastest way to a working environment; the manual steps that follow give you the same result with full control over versions.

1. $1

2. $1

3. $1

4. $1

5. $1

If that works, you can skip straight to [Your First Blueprint](/developers/getting-started/02-first-blueprint).

## Quick Install (Automated)

The [Scrypto repository](https://github.com/radixdlt/radixdlt-scrypto) ships [official install scripts](https://github.com/radixdlt/radixdlt-scrypto/tree/main/scrypto-install-scripts) for macOS, Debian/Ubuntu, and Windows that install a known-good, pinned toolchain in one step – [WASM](https://webassembly.org) target included. As of [Scrypto 1.3.1](https://www.radixdlt.com/blog/scrypto-1-3-1-unlocking-modern-rust-support) they pin [Rust](https://rustup.rs) 1.92.0, `radix-clis` 1.3.0, and [LLVM](https://llvm.org) 21. This is the fastest path if you want a working setup without choosing versions yourself; the manual steps below produce the same result with full control.

## 1. Install Rust

Install Rust via [rustup](https://rustup.rs). Scrypto 1.3.1 supports Rust 1.81.0 and newer (tested up to 1.92.0).

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
```

```bash
# Download and run the installer from https://rustup.rs
# Choose "Proceed with standard installation"
```

## 2. Add the [WASM](https://webassembly.org) Target

Scrypto compiles [blueprints](https://docs.radixdlt.com/docs/blueprints-and-components) to [WebAssembly](https://webassembly.org/) for deterministic execution on the [Radix Engine](/contents/tech/core-protocols/radix-engine).

`rustup target add wasm32-unknown-unknown`

## 3. Install Radix CLI Tools

The `radix-clis` crate provides `scrypto` (compiler), `resim` (local simulator), and `rtmc` (manifest compiler).

`cargo install --force radix-clis`Build time

First install compiles from source and may take several minutes. Subsequent installs are faster.

## 4. Verify

```bash
rustc --version
scrypto --version
resim --version
```
All three commands should print version numbers without errors.

## IDE Setup

For the best experience, install [VS Code](https://code.visualstudio.com/) with the [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer) extension. This gives you inline type hints, autocompletion, and error checking for Scrypto code.

## Troubleshooting

### Missing [WASM](https://webassembly.org) target

If you see `wasm32-unknown-unknown target not found`, re-run:

`rustup target add wasm32-unknown-unknown`### Outdated toolchain

If builds fail on a fresh install, update Rust:

`rustup update`

## Next Steps

- [Your First Blueprint](/developers/getting-started/02-first-blueprint) – write, build, and run a component on the local simulator

## External Links

- [Official install guide](https://docs.radixdlt.com/docs/getting-rust-scrypto)
- [Scrypto GitHub repository](https://github.com/radixdlt/radixdlt-scrypto)
- [Scrypto 1.3.1 release blog](https://www.radixdlt.com/blog/scrypto-1-3-1-unlocking-modern-rust-support)