Skip to main content

How to Run an Erigon Client Node

System Requirements

  • 16-core CPU
  • 64 GB RAM
  • Basically io1 or above with at least 20k+ iops and RAID-0 based disk structure

System Requirements

  • For an Archive node of Polygon Mainnet: 8TB
  • For an Archive node of Mumbai Testnet: 1TB
  • SSD or NVMe. Bear in mind that SSD performance deteriorates when close to capacity
  • RAM: >= 32GB, 64-bit architecture
  • Golang version >= 1.18, GCC 10+
HDD not recommended

On HDDs, Erigon will always stay N blocks behind the chain tip, but will not fall behind.

Install Erigon Client

Run the following commands to install Erigon:

git clone --recurse-submodules -j8
cd erigon
git checkout v0.0.8
make erigon

This should create the binary at ./build/bin/erigon

Use the tag v0.0.8 on our forked repo to have a stable version.

Start Erigon Client

To start Erigon, run:

erigon --chain=mumbai
  • Use chain=mumbai for Mumbai testnet
  • Use chain=bor-mainnet for Polygon Mainnet

Configure Erigon Client

  • If you want to store Erigon files in a non-default location, use -datadir
    erigon --chain=mumbai --datadir=<your_data_dir>
  • If you are not using local heimdall, use -bor.heimdall=<your heimdall url>. By default, it will try to connect to localhost:1317.
    erigon --chain=mumbai --bor.heimdall=<your heimdall url> --datadir=<your_data_dir>

Note: Remote heimdall is not recommended for production use, Only use it for testing purposes.

Tips for Faster Sync

  • Use the machine with high IOPS and RAM for the faster initial sync
  • Memory optimized nodes are recommended for faster sync, For example, AWS EC2 r5 or r6 series instances.