Installation

This guide will show how to build, install and update Curio binaries

Debian package installation

Curio packages are available to be installed directly on Ubuntu / Debian systems.

Debain packages are only available for mainnet right now. For any other network like calibration network or devnet, binaries must be built from source.

Install prerequisites

sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git jq pkg-config curl clang build-essential hwloc libhwloc-dev wget libarchive-dev -y && sudo apt upgrade -y

Enable Curio package repo

sudo wget -O /usr/share/keyrings/curiostorage-archive-keyring.gpg https://filecoin-project.github.io/apt/KEY.gpg

echo "deb [signed-by=/usr/share/keyrings/curiostorage-archive-keyring.gpg] https://filecoin-project.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/curiostorage.list

sudo apt update

Install Curio binaries based on your GPU.
For NVIDIA GPUs:
```
sudo apt install curio-cuda
```
For OpenCL GPUs:
```
sudo apt install curio-opencl
```

Linux Build from source

You can build the Curio executables from source by following these steps.

Software dependencies

You will need the following software installed to install and run Curio.

System-specific

Building Curio requires some system dependencies, usually provided by your distribution.

Arch:

sudo pacman -Syu opencl-icd-loader gcc git jq pkg-config opencl-icd-loader opencl-headers opencl-nvidia hwloc libarchive

Ubuntu/Debian:

sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git jq pkg-config curl clang build-essential hwloc libhwloc-dev wget libarchive-dev -y && sudo apt upgrade -y

Fedora:

sudo dnf -y install gcc make git jq pkgconfig mesa-libOpenCL mesa-libOpenCL-devel opencl-headers ocl-icd ocl-icd-devel clang llvm wget hwloc hwloc-devel libarchive-devel

OpenSUSE:

sudo zypper in gcc git jq make libOpenCL1 opencl-headers ocl-icd-devel clang llvm hwloc libarchive-devel && sudo ln -s /usr/lib64/libOpenCL.so.1 /usr/lib64/libOpenCL.so

Amazon Linux 2:

sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo yum install -y git gcc jq pkgconfig clang llvm mesa-libGL-devel opencl-headers ocl-icd ocl-icd-devel hwloc-devel libarchive-devel

Rustup

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Go

Example of an OLD version's CLI download:

wget -c https://golang.org/dl/go1.23.6.linux-amd64.tar.gz -O - | sudo tar -xz -C /usr/local

You’ll need to add /usr/local/go/bin to your path. For most Linux distributions you can run something like:

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc

System Configuration

Before you proceed with the installation, you should increase the UDP buffer. You can do this by running the following commands:

sudo sysctl -w net.core.rmem_max=2097152
sudo sysctl -w net.core.rmem_default=2097152

To persist the UDP buffer size across the reboot, update the /etc/sysctl.conf file.

echo 'net.core.rmem_max=2097152' | sudo tee -a /etc/sysctl.conf
echo 'net.core.rmem_default=2097152' | sudo tee -a /etc/sysctl.conf

Build and install Curio

Once all the dependencies are installed, you can build and install Curio.

Clone the repository:

git clone https://github.com/filecoin-project/curio.git
cd curio/

Switch to the latest stable release branch:
```
git checkout <release version>
```

Enable the use of SHA extensions by adding these two environment variables:

export RUSTFLAGS="-C target-cpu=native -g"
export FFI_BUILD_FROM_SOURCE=1

echo 'export RUSTFLAGS="-C target-cpu=native -g"' >> ~/.bashrc
echo 'export FFI_BUILD_FROM_SOURCE=1' >> ~/.bashrc
source ~/.bashrc

If you are using a Nvidia GPU, please set the below environment variables.

export FFI_USE_CUDA=1
export FFI_USE_CUDA_SUPRASEAL=1

echo 'export FFI_USE_CUDA=1' >> ~/.bashrc
echo 'export FFI_USE_CUDA_SUPRASEAL=1' >> ~/.bashrc
source ~/.bashrc

Curio is compiled to operate on a single network. Choose the network you want to join, then run the corresponding command to build the Curio node:
```
# For Mainnet:
make clean build

# For Calibration Testnet:
make clean calibnet
```
Install Curio. This will put curio in /usr/local/bin. curio will use the $HOME/.curio folder by default.
```
sudo make install
```
Run curio --version

curio version 1.24.5+mainnet+git_214226e7_2025-02-19T17:02:54+04:00
# or
curio version 1.24.5+calibnet+git_214226e7_2025-02-19T17:02:54+04:00

MacOS Build from source

You can build the Curio executables from source by following these steps.

Software dependencies

You must have XCode and Homebrew installed to build Curio from source.

XCode Command Line Tools

Curio requires that X-Code CLI tools be installed before building the Curio binaries.

Check if you already have the XCode Command Line Tools installed via the CLI, run:

xcode-select -p

This should output something like:

/Library/Developer/CommandLineTools

xcode-select --install

Next up is installing Curio’s dependencies using Homebrew.

Homebrew

Use the command brew install to install the following packages:

brew install jq pkg-config hwloc coreutils
brew install go@1.23

Next up is cloning the Lotus repository and building the executables.

Rust

Rustup is an installer for the systems programming language Rust. Run the installer and follow the onscreen prompts. The default installation option should be chosen unless you are familiar with customisation:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Build and install Curio

The installation instructions are different depending on which CPU is in your Mac:

Arm based CPUs

Clone the repository:

git clone https://github.com/filecoin-project/curio.git
cd curio/

Switch to the latest stable release branch:
```
git checkout <release version>
```

Create the necessary environment variables to allow Curio to run on Arm architecture:

export LIBRARY_PATH=/opt/homebrew/lib
export FFI_BUILD_FROM_SOURCE=1
export PATH="$(brew --prefix coreutils)/libexec/gnubin:/usr/local/bin:$PATH"

Build the curio binary:
```
make clean curio
```
Run the final make command to move this curio executable to /usr/local/bin. This allows you to run curio from any directory.
```
sudo make install
```

Run curio --version

curio version 1.24.5+mainnet+git_214226e7_2025-02-19T17:02:54+04:00
# or
curio version 1.24.5+calibnet+git_214226e7_2025-02-19T17:02:54+04:00

Intel CPUs

Clone the repository:

git clone https://github.com/filecoin-project/curio.git
cd curio/

Switch to the latest stable release branch:
```
git checkout <release version>
```
Build and install Curio:
```
make clean curio
sudo make install
```

Run curio --version

curio version 1.23.0+mainnet+git_ae625a5_2024-08-21T15:21:45+04:00
# or
curio version 1.23.0+calibnet+git_ae625a5_2024-08-21T15:21:45+04:00

PreviousVersions NextSetup

Last updated 2 months ago

Installation

This guide will show how to build, install and update Curio binaries

Debian package installation

Curio packages are available to be installed directly on Ubuntu / Debian systems.

Debain packages are only available for mainnet right now. For any other network like calibration network or devnet, binaries must be built from source.

Install prerequisites

sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git jq pkg-config curl clang build-essential hwloc libhwloc-dev wget libarchive-dev -y && sudo apt upgrade -y

Enable Curio package repo

sudo wget -O /usr/share/keyrings/curiostorage-archive-keyring.gpg https://filecoin-project.github.io/apt/KEY.gpg

echo "deb [signed-by=/usr/share/keyrings/curiostorage-archive-keyring.gpg] https://filecoin-project.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/curiostorage.list

sudo apt update

Install Curio binaries based on your GPU.
For NVIDIA GPUs:
```
sudo apt install curio-cuda
```
For OpenCL GPUs:
```
sudo apt install curio-opencl
```

Linux Build from source

You can build the Curio executables from source by following these steps.

Software dependencies

You will need the following software installed to install and run Curio.

System-specific

Building Curio requires some system dependencies, usually provided by your distribution.

Arch:

sudo pacman -Syu opencl-icd-loader gcc git jq pkg-config opencl-icd-loader opencl-headers opencl-nvidia hwloc libarchive

Ubuntu/Debian:

sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git jq pkg-config curl clang build-essential hwloc libhwloc-dev wget libarchive-dev -y && sudo apt upgrade -y

Fedora:

sudo dnf -y install gcc make git jq pkgconfig mesa-libOpenCL mesa-libOpenCL-devel opencl-headers ocl-icd ocl-icd-devel clang llvm wget hwloc hwloc-devel libarchive-devel

OpenSUSE:

sudo zypper in gcc git jq make libOpenCL1 opencl-headers ocl-icd-devel clang llvm hwloc libarchive-devel && sudo ln -s /usr/lib64/libOpenCL.so.1 /usr/lib64/libOpenCL.so

Amazon Linux 2:

sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo yum install -y git gcc jq pkgconfig clang llvm mesa-libGL-devel opencl-headers ocl-icd ocl-icd-devel hwloc-devel libarchive-devel

Rustup

Curio needs . The easiest way to install it is:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Go

To build Curio, you need a working installation of : It needs to be at-least .

Example of an OLD version's CLI download:

wget -c https://golang.org/dl/go1.23.6.linux-amd64.tar.gz -O - | sudo tar -xz -C /usr/local

You’ll need to add /usr/local/go/bin to your path. For most Linux distributions you can run something like:

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc

See the if you get stuck.

System Configuration

Before you proceed with the installation, you should increase the UDP buffer. You can do this by running the following commands:

sudo sysctl -w net.core.rmem_max=2097152
sudo sysctl -w net.core.rmem_default=2097152

To persist the UDP buffer size across the reboot, update the /etc/sysctl.conf file.

echo 'net.core.rmem_max=2097152' | sudo tee -a /etc/sysctl.conf
echo 'net.core.rmem_default=2097152' | sudo tee -a /etc/sysctl.conf

Build and install Curio

Once all the dependencies are installed, you can build and install Curio.

Clone the repository:

git clone https://github.com/filecoin-project/curio.git
cd curio/

Switch to the latest stable release branch:
```
git checkout <release version>
```

Enable the use of SHA extensions by adding these two environment variables:

export RUSTFLAGS="-C target-cpu=native -g"
export FFI_BUILD_FROM_SOURCE=1

echo 'export RUSTFLAGS="-C target-cpu=native -g"' >> ~/.bashrc
echo 'export FFI_BUILD_FROM_SOURCE=1' >> ~/.bashrc
source ~/.bashrc

If you are using a Nvidia GPU, please set the below environment variables.

export FFI_USE_CUDA=1
export FFI_USE_CUDA_SUPRASEAL=1

echo 'export FFI_USE_CUDA=1' >> ~/.bashrc
echo 'export FFI_USE_CUDA_SUPRASEAL=1' >> ~/.bashrc
source ~/.bashrc

Curio is compiled to operate on a single network. Choose the network you want to join, then run the corresponding command to build the Curio node:
```
# For Mainnet:
make clean build

# For Calibration Testnet:
make clean calibnet
```
Install Curio. This will put curio in /usr/local/bin. curio will use the $HOME/.curio folder by default.
```
sudo make install
```
Run curio --version

curio version 1.24.5+mainnet+git_214226e7_2025-02-19T17:02:54+04:00
# or
curio version 1.24.5+calibnet+git_214226e7_2025-02-19T17:02:54+04:00

You should now have Curio installed. You can now .

MacOS Build from source

You can build the Curio executables from source by following these steps.

Software dependencies

You must have XCode and Homebrew installed to build Curio from source.

XCode Command Line Tools

Curio requires that X-Code CLI tools be installed before building the Curio binaries.

Check if you already have the XCode Command Line Tools installed via the CLI, run:

xcode-select -p

This should output something like:

/Library/Developer/CommandLineTools

If this command returns a path, then you have Xcode already installed! You can . If the above command doesn’t return a path, install Xcode:

xcode-select --install

Next up is installing Curio’s dependencies using Homebrew.

Homebrew

We recommend that macOS users use to install each of the necessary packages.

Use the command brew install to install the following packages:

brew install jq pkg-config hwloc coreutils
brew install go@1.23

Next up is cloning the Lotus repository and building the executables.

Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Build and install Curio

The installation instructions are different depending on which CPU is in your Mac:

Arm based CPUs

Clone the repository:

git clone https://github.com/filecoin-project/curio.git
cd curio/

Switch to the latest stable release branch:
```
git checkout <release version>
```

Create the necessary environment variables to allow Curio to run on Arm architecture:

export LIBRARY_PATH=/opt/homebrew/lib
export FFI_BUILD_FROM_SOURCE=1
export PATH="$(brew --prefix coreutils)/libexec/gnubin:/usr/local/bin:$PATH"

Build the curio binary:
```
make clean curio
```
Run the final make command to move this curio executable to /usr/local/bin. This allows you to run curio from any directory.
```
sudo make install
```

Run curio --version

curio version 1.24.5+mainnet+git_214226e7_2025-02-19T17:02:54+04:00
# or
curio version 1.24.5+calibnet+git_214226e7_2025-02-19T17:02:54+04:00

You should now have Curio installed. You can now .

Intel CPUs

❗These instructions are for installing Curio on an Intel Mac. If you have an Arm-based CPU, use the

Clone the repository:

git clone https://github.com/filecoin-project/curio.git
cd curio/

Switch to the latest stable release branch:
```
git checkout <release version>
```
Build and install Curio:
```
make clean curio
sudo make install
```

Run curio --version

curio version 1.23.0+mainnet+git_ae625a5_2024-08-21T15:21:45+04:00
# or
curio version 1.23.0+calibnet+git_ae625a5_2024-08-21T15:21:45+04:00

You can now .

PreviousVersions NextSetup

Last updated 2 months ago