If you face any issues while installing, check out the FAQ.
Precompiled binaries are available from the GitHub releases page. These are better managed by using Foundryup.
Foundryup is the Foundry toolchain installer. You can find more about it here.
Open your terminal and run the following command:
curl -L https://foundry.paradigm.xyz | bash
This will install Foundryup, then simply follow the instructions on-screen,
which will make the
foundryup command available in your CLI.
foundryup by itself will install the latest (nightly) precompiled binaries:
foundryup --help for more options, like installing from a specific version or commit.
If you're on Windows, you will need to install and use Git BASH or WSL, as your terminal, since Foundryup currently does not support Powershell or Cmd.
Building from source
You will need the Rust compiler and Cargo, the Rust package manager.
The easiest way to install both is with
On Windows, you will also need a recent version of Visual Studio, installed with the "Desktop Development With C++" Workloads option.
You can either use the different Foundryup flags:
foundryup --branch master foundryup --path path/to/foundry
Or, by using a single Cargo command:
cargo install --git https://github.com/foundry-rs/foundry --profile local --force foundry-cli anvil chisel
Or, by manually building from a local copy of the Foundry repository:
# clone the repository git clone https://github.com/foundry-rs/foundry.git cd foundry # install Forge + Cast cargo install --path ./cli --profile local --bins --force # install Anvil cargo install --path ./anvil --profile local --force # install Chisel cargo install --path ./chisel --profile local --force
Installing for CI in Github Action
See the foundry-rs/foundry-toolchain GitHub Action.
Using Foundry with Docker
Foundry can also be used entirely within a Docker container. If you don't have it, Docker can be installed directly from Docker's website.
Once installed, you can download the latest release by running:
docker pull ghcr.io/foundry-rs/foundry:latest
It is also possible to build the docker image locally. From the Foundry repository, run:
docker build -t foundry .
For examples and guides on using this image, see the Docker tutorial section.
Some machines (including those with M1 chips) may be unable to build the docker image locally. This is a known issue.