Linux

The following instructions are specific to Linux installations.

There are several ways to install Lotus on Linux:

Downloading from Github

  1. Install Lotus dependencies:

Arch:

sudo pacman -Syu hwloc

Ubuntu/Debian:

sudo apt install -y hwloc

Fedora:

sudo dnf -y install hwloc

OpenSUSE:

sudo zypper in hwloc

Amazon Linux 2:

sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo yum install -y hwloc-devel

  1. Download the latest Linux bundle from the Lotus GitHub releases page:

    wget https://github.com/filecoin-project/lotus/releases/download/v1.33.0/lotus_v1.33.0_linux_amd64_V1.tar.gz

  2. Extract tar -xvf archive.tar.gz executable:

    tar -xvf lotus_v1.33.0_linux_amd64.tar.gz

  3. Move the lotus binary to /usr/local/bin:

    sudo mv lotus_1.33.0_linux_amd64/lotus /usr/local/bin/lotus

Building from source

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

Software dependencies

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

System-specific

Building Lotus 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

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 -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

OpenSUSE:

sudo zypper in gcc git jq make libOpenCL1 opencl-headers ocl-icd-devel clang llvm hwloc && 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

Rustup

Lotus needs rustup. The easiest way to install it is:

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

Go

To build Lotus, you need a working installation of Go 1.23.7 or higher:

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

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

Build and install Lotus

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

  1. Clone the repository:

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

  2. Switch to the latest stable release branch:

    git pull
LATEST_RELEASE=$(git tag -l 'v*' | grep -v "-" | sort -V -r | head -n 1) # Finds the latest Lotus Node release
git checkout $LATEST_RELEASE

    The latest production release can be found on GitHub or via the command line.

  3. If you are in China, see “Lotus: tips when running in China”.

  4. Depending on your CPU model, you will want to export additional environment variables:

    a. If you have an AMD Zen or Intel Ice Lake CPU (or later), 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

    See the Native Filecoin FFI section for more details about this process.

    a. Some older Intel and AMD processors without the ADX instruction support may panic with illegal instruction errors. To solve this, add the CGO_CFLAGS environment variable:

    export CGO_CFLAGS_ALLOW="-D__BLST_PORTABLE__"
export CGO_CFLAGS="-D__BLST_PORTABLE__"

    a. By default, a ‘multicore-sdr’ option is used in the proofs library. This feature is also used in FFI unless explicitly disabled. To disable building with the ‘multicore-sdr’ dependency, set FFI_USE_MULTICORE_SDR to 0:

    export FFI_USE_MULTICORE_SDR=0

  5. Build and install Lotus

    Lotus is compiled to operate on a single network.

    Choose the network you want to join, then run the corresponding command to build the Lotus node:

    # For Mainnet:
make all

# For Calibration Testnet:
make calibnet

    Install Lotus:

    sudo make install

    This will put lotus, lotus-miner and lotus-worker in /usr/local/bin.

    lotus will use the $HOME/.lotus folder by default for storage (configuration, chain data, wallets). See advanced options for information on how to customize the Lotus folder.

    Once the installation is finished, use the command down below to ensure lotus is installed successfully for the right network.

    lotus --version

    lotus version 1.23.3+mainnet+git.7bb1f98ac
# or
lotus version 1.23.3+calibnet+git.7bb1f98ac

  6. You should now have Lotus installed. You can now start the Lotus daemon.

Native Filecoin FFI

Some newer CPU architectures like AMD’s Zen and Intel’s Ice Lake have support for SHA extensions. Having these extensions enabled significantly speeds up your Lotus node. To make full use of your processor’s capabilities, make sure you set the following variables before building from source:

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

This method of building does not produce portable binaries. Make sure you run the binary on the same computer as you built it.

Systemd service files

Lotus provides generic Systemd service files. They can be installed with:

make install-daemon-service
make install-miner-service

Edit this page on GitHub

← Prerequisites
MacOS →