How to Install Foundry

My notes on getting Foundry installed on macOS and Linux. Just the commands and a few quick checks to make sure it's working.

Getting Foundry set up is the first step for any project. I use foundryup, the official installer, to manage my installation. It’s a straightforward process that works the same on macOS and Linux.

This is how I do it on a new machine.

Install foundryup

First, I run the installer script from the terminal. This downloads and installs foundryup, which is the tool that manages Foundry’s binaries.

curl -L https://foundry.paradigm.xyz | bash

After the script finishes, I need to either restart my terminal or source my profile file (like .zshrc or .bashrc) for the foundryup command to be available.

Install Foundry

With foundryup installed, I can now install the latest precompiled binaries for forge, cast, anvil, and chisel.

foundryup

Running this command downloads and installs the core components of Foundry.

Verify the Installation

To make sure everything is working, I check the version of forge.

forge --version

If it prints out a version number like 1.4.2-stable, the installation was successful.

forge Version: 1.4.2-stable
Commit SHA: 828441d243f552f82c5a89bdc818e52bdd57b26b
Build Timestamp: 2025-10-18T08:19:39.947006000Z (1760775579)
Build Profile: maxperf

How to Update Foundry

When a new version of Foundry is released, I use foundryup again to update my local installation. It’s the same command I used to install it.

foundryup

This keeps my tools up to date with the latest features and fixes.