Prerequisites

Please make sure to read the getting-started guide before proceeding with the installation. This page provide details on Lotus installation prerequisites and supported platforms.

Minimal requirements

To run a Lotus node your computer must have:

  • macOS or Linux installed. Windows is not yet supported.
  • 8-core CPU and 32 GiB RAM. Models with support for Intel SHA Extensions (AMD since Zen microarchitecture or Intel since Ice Lake) will significantly speed things up.
  • Enough space to store the current Lotus chain (preferably on an SSD storage medium). The chain grows at approximately 38 GiB per day. The chain can be synced from trusted state snapshots and compacted or pruned to a minimum size of around 33Gib. The full history was around 10TiB in June of 2021.

Nodes in China

A few tips for users in China to get around some of the bandwidth issues or slowness they can suffer when building and running Lotus."

Speed up proof parameter download for first boot

Running Lotus requires the download of chain’s proof parameters which are large files which by default are hosted outside of China and very slow to download there. To get around that, users should set the following environment variable when running either of lotus, lotus-miner and lotus-worker:

export IPFS_GATEWAY=https://proof-parameters.s3.cn-south-1.jdcloud-oss.com/ipfs/

Speed up Go module download during builds

Building Lotus requires downloading a few Go modules. These are usually hosted on Github, which has very low bandwidth from China. To fix this use a local proxy by setting the following variable before running Lotus:

export GOPROXY=https://goproxy.cn

Supported Platforms

Currently, lotus installation is supported on the following platforms.

Edit this page on GitHub