Set up an Archive Node Client on Polygon



Set up an Archive Node Client on Polygon


This tutorial provides instructions on how to set up an Archive Node client using Erigon. The tutorial includes instructions on how to install and start Erigon, as well as how to configure it to connect to a specific network and store files in a non-default location. Additionally, tips are provided on how to optimize the sync process by using a machine with high IOPS and RAM, and increasing the snapshot download and upload speed.

System Requirements

Archive Node

16-core CPU


Basically io1 or above with at least 20k+ iops and raid-0 based disk structure

Erigon Client

For an Archive node of Polygon Mainnet: 5TB

For an Archive node of Polygon Mumbai: 1TB

SSD or NVMe. Bear in mind that SSD performance deteriorates when close to capacity

RAM: >= 16GB, 64-bit architecture

Golang version >= 1.18, GCC 10+


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

Erigon Client Setup

How to Install

Run the following commands to install Erigon:

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


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

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

How to Start

To start Erigon, run:

erigon --chain=mumbai


Use chain=mumbai for Mumbai testnet

Use chain=bor-mainnet for Polygon Mainnet

How to Configure Erigon

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>


If you want to connect to Polygon Mumbai Testnet use:

For Polygon Mainnet:

Tips for Faster Sync

Use the machine with high IOPS and RAM for the faster initial sync

Use the below commands to increase snapshot download/upload speed:



Replace 512 with whatever bandwidth your machine can manage.