Install

Recommended Hardware: 4 Cores, 8GB RAM, 250 GB SSD

Update system and install build tools

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential apt-transport-https ca-certificates curl software-properties-common
sudo apt -qy upgrade

Install Docker

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
docker --version
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Clone project repository

cd $HOME
rm -rf starknet-stack
git clone https://github.com/starknet-edu/starknet-stack.git

Create a service

sudo tee $HOME/starknet-stack/docker-compose.yaml > /dev/null << EOF
services:
  pathfinder:
    image: eqlabs/pathfinder:v0.20.4
    container_name: starknet-mainnet
    restart: unless-stopped
    ports:
      - "9545:9545"
    volumes:
      - ./data:/usr/share/pathfinder/data
    environment:
      - RUST_LOG=info
    command: >
      --ethereum.url <your_ethereum_mainnet_rpc>
      --network mainnet
      --sync.l1-poll-interval 5000
    user: "root:root"
EOF

Start service and check the logs

cd $HOME/starknet-stack
docker-compose up -d
docker logs starknet-mainnet --tail 20 -f

If you don’t want to synchronize your Starknet node from scratch, you can use a pre-synced database snapshot from the official source: 👉 https://eqlabs.github.io/pathfinder/database-snapshots