Skip to content


Getting Started

The Raspberry Pi is small, inexpensive, and meets the requirements to run an Ergo full node.


  • Pi4 with 4gb RAM or above is optimal.
  • Due to the intensive disk I/O, a SSD with 64GB+ is preferred.


sudo apt update && sudo apt upgrade -y
sudo apt install default-jdk -y

Install the Java JDK

sudo apt install default-jdk


The Raspberry Pi is a very powerful device but it has some limitations which prevent it from syncing a full Ergo node quickly and efficiently. Below are a few things you can do to ensure a smooth setup process.

Increase the swap space your Pi has access to

sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile

Increase to 4096 (MB)


Then re-enable the swap and reboot.

sudo dphys-swapfile setup
sudo dphys-swapfile swapon
sudo reboot now

More tips

  • WiFi has less issues than Ethernet
  • Make sure your Pi is in a well-vented area.
  • Disable your screen-saver for the sync.
  • Using ZRAM

Quick Start

This script will download the latest version of the node, prompt you to set an API key, and start the sync while displaying the progress in terminal.

bash -c "$(curl -s"

If you'd prefer to get set up manually, here's a step-by-step guide. When ready to launch the node make sure to set a maximum limit of 2GB by using the -Xmx2g flag.

Light Mode

A basic config on mainnet should look like this

ergo {
    node {
        mining = false


scorex {
    restApi {
        apiKeyHash = "$BLAKE_HASH"

There are several configuration options that be tweaked in your ergo.conf file. The resource directory on the main GitHub repository has examples of all available options.

  • skipV1TransactionsValidation: Skip validation of transactions before block 417,792
  • blocksToKeep denotes the number of blocks to keep with transactions and ADproofs.
  • stateType with the options utxo and digest.
  • utxo keep full utxo set, that allows to validate arbitrary block and generate ADProofs. (default)
  • digest - keep state root hash only and validate transactions via ADProofs.
  • maxConnections: The maximum amount of peers the node should try and connect to over the P2P layer.


java -jar -Xmx2g ergo.jar --mainnet -c ergo.conf