Mainnet docs are version-pinned. Check each section's exact version in the sidebar; it can lag the newest upstream release.
This guide will help you to install the Fuel toolchain binaries and prerequisites.
Channel semantics verified July 23, 2026. Fuelup's
latestchannel is an alias formainnet; it does not mean the newest upstream compiler and it is not the testnet channel. See the Fuelup channel reference and the published mainnet and testnet manifests.
This guide covers the following topics:
fuelup fuelup is the official package manager for Fuel that installs the Fuel toolchain
from the official release channels, enabling you to easily switch between different
toolchains and keep them updated. It makes building and maintaining Sway applications simpler with forc and fuel-core for common platforms.
💡 Check out the Fuelup docs for more information.
fuelup-init To install the Fuel toolchain, you can use the fuelup-init script.
This will install forc, forc-client, forc-fmt, forc-lsp, forc-wallet as well as fuel-core in ~/.fuelup/bin.
👉 Just paste the following line in your terminal and press Enter.
curl https://install.fuel.network | sh🚧 Be aware that currently we do not natively support Windows. If you wish to use
fuelupon Windows, please use Windows Subsystem for Linux.
Once the script is downloaded, it will be executed automatically.
The fuelup-init script will prompt you with the question below:
fuelup uses "/home/username/.fuelup" as its home directory to manage the Fuel toolchain, and will install binaries there.
To use the toolchain, you will have to configure your PATH, which tells your machine where to locate `fuelup` and the Fuel toolchain.
If permitted, fuelup-init will configure your PATH for you by running the following:
echo "export PATH="$HOME/.fuelup/bin:$PATH"" >> /home/username/.bashrc
Would you like fuelup-init to modify your PATH variable for you? (N/y) 👉 Press the Y key in your terminal and press Enter to modify your PATH.
After allowing the fuelup-init script to modify your PATH variable, you will see information about the packages being downloaded and installed. A successful installation reports where fuelup was installed. The manager and component versions change independently, so this guide does not embed a sample version number.
👉 Use fuelup --version any time to check which version of the package you are using.
fuelup --versionCompare the reported version with the latest Fuelup release .
If you're using VSCode, we recommend installing the Sway extension .
Just as in Rust , Fuel supports multiple toolchains.
A toolchain is a collection of tools (such as the compiler, LSP, etc).
By default, fuelup includes a series of packages tested to work with each other, providing a reliable set of tools.
The installer may configure the latest toolchain by default. latest is an alias for the mainnet-compatible distribution. Select testnet explicitly when developing against the testnet network.
| Channel | Use |
|---|---|
mainnet | Toolchain distributed for Fuel mainnet |
testnet | Toolchain distributed for Fuel testnet |
latest | Alias for mainnet; not the newest upstream compiler |
nightly | Development tooling; not a network compatibility promise |
Prefer the explicit mainnet or testnet name in project setup and CI, even when latest currently resolves to the same manifest as mainnet.
Make sure you have the latest version of fuelup so you can access the latest features and have the best performance.
👉 Update fuelup by running the following command:
fuelup self update The download URL and version in the command output will vary by release and platform. Run fuelup --version after the update to verify the installed manager.
For mainnet, install and select the explicitly named channel:
fuelup toolchain install mainnet
fuelup default mainnetFor testnet, use the separate testnet channel:
fuelup toolchain install testnet
fuelup default testnet Changing the default affects subsequent commands globally. For a project or CI environment, record the intended network channel alongside the component versions and commit the project's Forc.lock.
👉 Run the following command to verify the active toolchain and component versions:
fuelup showConfirm that the active toolchain is the named channel you intended. Compare its component versions with that channel's published manifest; do not compare a network channel with the newest Sway GitHub release as though they were the same release stream.
nightly toolchain In case you want to try out the unreleased features of the Fuel toolchain, you can install the nightly toolchain.
👉 Run the following command to install the nightly toolchain:
fuelup toolchain install nightlyIf the toolchain was successfully installed, you will see this output:
The Fuel toolchain is installed and up to date The toolchain was installed correctly, however is not in use yet. Next, you need to configure fuelup to use the nightly toolchain as the default.
👉 Set nightly as your default toolchain with the following command:
fuelup default nightly You will get the following output indicating that you have successfully set nightly as your default toolchain.
default toolchain set to nightlySometimes you might end up using multiple toolchains at once. Don't worry if you get confused about which toolchain you are using, since you can check your current toolchain anytime.
👉 Run the fuelup show command to see the toolchain and the versions of each tool you are using.
fuelup showThe output lists the active channel and the installed version of each component. These versions are generated from the channel manifest and can change when a channel is promoted. Forc plugins can also have independent release versions, so use the output from your own environment when reporting a problem.
The forc-wallet plugin is packaged alongside the default distributed toolchains when installed using fuelup, so you should already have this installed if you've followed the instructions above.
To initialize a new wallet with forc-wallet, you can run the command below:
forc wallet newAfter typing in a password, be sure to save the mnemonic phrase that is output.
Next, create a new wallet account with:
forc wallet account new With this, you'll get a fuel address that looks something like this: fuel1efz7lf36w9da9jekqzyuzqsfrqrlzwtt3j3clvemm6eru8fe9nvqj5kar8.
If you need to list your accounts, you can run the command below:
forc wallet accounts If you want to develop with the fuels Rust SDK, you will need to install Rust on your machine. To install Rust, you can use the rustup tool.
You don't need to install Rust if you don't plan on using the Rust SDK.
Run the following command in your shell; this downloads and runs rustup-init.sh, which in turn downloads and runs the correct version of the rustup-init executable for your platform.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shCheck the official Rust documentation to get more information on installing the Rust toolchain .
Now you are ready to start building with Fuel.
👉 Check out the counter dapp guide to deploy your first smart contract.
You can create your own set of specific versions, this is known as 'custom toolchains'.
👉 Visit the Fuelup docs to learn how to set up your own custom toolchains.
You can always build the Fuel packages from source.
👉 Visit the Fuelup docs to get more details about other types of installation.
It's always possible to run a development environment in the browser.
👉 Visit our guide on Github Codespaces to use the Fuel toolchain in the browser.