The Ergo Reference Client (Node)
The Ergo Node is the core software that connects to the Ergo P2P network, validates transactions and blocks, and maintains a copy of the entire blockchain. Running a node is crucial for the network's decentralization and security.
Setup
Install and configure your Ergo node with step-by-step guides for different platforms and deployment methods.
Testnet
Get started with Ergo testnet for development and testing. Access testnet resources and configuration.
Protocol
Learn about the Ergo network protocol, P2P communication, and blockchain validation mechanisms.
Configuration
Configure your node settings, optimize performance, and customize node behavior for your needs.
Modes of Operation
Explore different node operation modes: full archival, pruned full node, and light full node.
Public Nodes
- There is a public node available at 213.239.193.208:9053
- A redundancy can also be provided on request to [email protected]
- A dynamic list of available public nodes can be found at api.tokenjay.app/peers/list
To set up your own node please see this page.
Minimum Requirements & Prerequisites
Java
An Ergo node requires a JDK/JRE version >= 9 installed on your system. We recommend using Oracle Java SE or SDKMAN for Unix-based systems:
curl -s "https://get.sdkman.io" | bash sdk install java 11.0.13.8.1-amzn
Hardware
The minimum hardware requirements are approximately:
- ~20GB of storage for the blockchain
- ~8GB of RAM for handling the initial sync
- 4-6GB of RAM available for the node process
- Fast SSD recommended for disk I/O
Running with the -Xmx4G flag on the JVM is advised.
Modes of Operation
Full Archival Node
This mode stores the entire blockchain history. To install from scratch, refer to the manual install page for detailed instructions.
Pruned Full Node
Bootstrap a pruned full node using a verified UTXO set snapshot and NiPoPoWs. Achieve full node security on standard hardware within minutes.
Light Full Node
This mode only holds the root digest of the state dictionary and checks full blocks or a suffix of the blockchain.
Per Device
Developer Resources
DeepWiki Documentation
For an alternative and potentially more detailed documentation source generated from the repository, explore the Ergo Node on DeepWiki.
Toolkits
- • Explorer & Node Bundles
- • Ergosphere (Umbrel-like solution)
- • Ergode (TypeScript implementation)
Additional Resources
- • ergonodes.net - Overview of live nodes
- • Node Frequently Asked Questions
- • Modes of Operation
- • Node APIs
- • Node Configuration
- • Node Protocol Details