The following instructions are specific to Linux installations.
There are several ways to install Lotus on Linux:
Storage providers should build from source.
Building Lotus from source allows you to strictly configure how Lotus runs and how it communicates with its dependencies. Storage providers looking to improve their system efficiency should install Lotus by building from source.
Downloading from Github
- Install Lotus dependencies:
sudo pacman -Syu hwloc
sudo apt install -y hwloc
sudo dnf -y install hwloc
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
Download the latest Linux bundle from the Lotus GitHub releases page:
Extract tar -xvf archive.tar.gz executable:
tar -xvf lotus_v1.25.2_linux_amd64.tar.gz
sudo mv lotus_1.25.2_linux_amd64/lotus /usr/local/bin/lotus
Building from source
You can build the Lotus executables from source by following these steps.
You will need the following software installed to install and run Lotus.
Building Lotus requires some system dependencies, usually provided by your distribution.
sudo pacman -Syu opencl-icd-loader gcc git bzr jq pkg-config opencl-icd-loader opencl-headers opencl-nvidia hwloc
sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl clang build-essential hwloc libhwloc-dev wget -y && sudo apt upgrade -y
sudo dnf -y install gcc make git bzr jq pkgconfig mesa-libOpenCL mesa-libOpenCL-devel opencl-headers ocl-icd ocl-icd-devel clang llvm wget hwloc hwloc-devel
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 bzr jq pkgconfig clang llvm mesa-libGL-devel opencl-headers ocl-icd ocl-icd-devel hwloc-devel
Lotus needs rustup. The easiest way to install it is:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
To build Lotus, you need a working installation of Go 1.20.7 or higher:
wget -c https://golang.org/dl/go1.20.7.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 official Golang installation instructions if you get stuck.
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.
Clone the repository:
git clone https://github.com/filecoin-project/lotus.git cd lotus/
Switch to the latest stable release branch:
git checkout releases
releasesbranch always contains the latest stable release for Lotus. If you want to checkout to a network other than mainnet, take a look at the Switching networks guide →
If you are in China, see “Lotus: tips when running in China”.
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
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
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
sudo make install
This will put
lotuswill use the
$HOME/.lotusfolder 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 1.23.3+mainnet+git.7bb1f98ac # or lotus version 1.23.3+calibnet+git.7bb1f98ac
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"
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:
Provided service files should be inspected and edited according to user needs as they are very generic and may lack specific environment variables and settings needed by the users.
One example is that logs are redirected to files in
/var/log/lotus by default and not visible in