⚙️ Installation

Recommended Hardware:

Node Type	CPU	RAM	Storage
Mainnet	4	8GB	250GB

Update system and install build tools

sudo apt -q update
sudo apt -qy install curl git jq lz4 zstd build-essential
sudo apt -qy upgrade

Install Docker

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
docker --version

Install Docker Compose

curl -L "https://github.com/docker/compose/releases/download/v2.10.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
ln -sf /usr/local/bin/docker-compose /usr/bin/docker-compose
docker-compose --version

Set the variables

STARKNET_RPC=<your_ethereum_mainnet_rpc>
echo 'export STARKNET_RPC='$STARKNET_RPC >> $HOME/.bash_profile
source $HOME/.bash_profile

Get ethereum_mainnet_rpc on one of Alchemy and Infura services

Create a directory

mkdir -p $HOME/pathfinder

Start the pathfinder container

sudo docker run \
  --name pathfinder \
  --restart unless-stopped \
  --detach \
  -p 9545:9545 \
  --user "$(id -u):$(id -g)" \
  -e RUST_LOG=info \
  -e PATHFINDER_ETHEREUM_API_URL=$STARKNET_RPC \
  -v $HOME/pathfinder:/usr/share/pathfinder/data \
  eqlabs/pathfinder

Check logs

sudo docker logs -fn100 pathfinder