Ergo Setup is a free, open-source package for people who want to run their own Ergo node, block explorer and GraphQL interface on a Windows PC without assembling each component by hand. It is built as a Docker Compose setup, so the parts start together from one configuration. It suits developers, analysts and hobbyists who want a local copy of Ergo blockchain data to query.
Before you start, note that the project's last code update was in April 2023, more than two years ago. That does not make it unusable, but it may lag behind current Ergo releases and Docker versions, so treat it as an experimental tool and review the setup before relying on it. Windows is mentioned in the project documentation, although it has not been formally verified on the platform. A fork by reqlez is also listed.
What Is an Ergo Node and Why Run One Locally?
A node is a program that keeps a copy of a blockchain and checks the data it receives against the network's rules. Running one yourself means your queries do not depend on a third-party service that might change its terms, rate limits or availability.
The trade-off is cost in time and resources. A full copy of the chain takes disk space, bandwidth and patience to sync, and the machine needs to stay online for the node to remain current. For a developer testing an application, those costs are often worth it because the data is local and predictable.
A local node is also useful for learning. Watching blocks arrive and seeing how transactions appear in the chain can make abstract blockchain concepts far easier to understand than reading about them alone.
How a Block Explorer and GraphQL Layer Work Together
A block explorer reads blocks from a node and presents them in a human-friendly form. You can look up a transaction, follow an address or check how many blocks have been produced recently. It turns raw chain data into something you can browse.
A GraphQL interface sits on top of that data and lets applications ask for exactly the fields they need. Instead of downloading whole blocks, a dashboard can request only balances, timestamps or transaction counts. This keeps queries focused and makes it easier to build custom views.
For example, a developer might build a small dashboard that shows recent activity for a test wallet. The explorer helps verify each result by eye, while the GraphQL layer feeds the dashboard programmatically. Having both in one local stack saves a lot of setup time.
Who Should Consider a Docker-Based Ergo Setup?
This setup fits developers who want a local Ergo environment for building or testing software. It also suits data analysts who need repeatable queries against chain data without relying on a public service for every question.
It is less suited to people who expect a polished, point-and-click desktop program. Because the stack is built around Docker, you will need to be comfortable reading configuration files, starting containers and checking logs when something goes wrong.
Students and hobbyists can also benefit, especially if they treat the project as a learning environment. Running each component in its own container makes it easier to see how a node, an indexer and an API relate to one another.
Key features
Node, Explorer and GraphQL in One Stack
Docker-Based Packaging
Public Source Code
Supported coins
The project documentation names Ergo (ERG) as its supported network. The stack is built around a single Ergo node, so its scope is Ergo rather than other blockchains.
How to install Ergo Setup on Windows
- 1
Check Docker and Docker Compose
Install Docker on your Windows PC and confirm that Docker Compose is available. Start Docker and make sure it is running before you go further, because the stack cannot launch without it.
- 2
Download the Project
Get the project only from the official GitHub repository at github.com/abchrisxyz/ergo-setup. You can clone it with Git or download the archive from the page. Avoid copies on unrelated download sites.
- 3
Read the Configuration Files
Open the README and the Compose files before you start anything. Check which services will run, which ports they use and where data will be stored on your disk. Make sure you have enough free space for the chain data.
- 4
Start the Stack
Follow the Compose command given in the project's README from the folder that contains the files. The first launch can take a long time because the node has to sync. Leave the window open and watch the logs for errors.
-
Confirm the Services Are Running
Check that the node, explorer and GraphQL interface are all up. Open the explorer in your browser and run a simple GraphQL query to confirm that data is flowing. If a service fails, read its container log before changing settings.
System requirements
- Windows, as mentioned in the project documentation; formal verification on Windows has not been completed
- Docker with Docker Compose installed and running
- Enough free disk space and bandwidth to store and sync a full Ergo node
How to use Ergo Setup
Once the stack is running, you work with it through the browser and the GraphQL endpoint. The steps below assume the services started without errors.
- Open the block explorer in your browser and confirm that the latest block height is increasing.
- Look up a recent block to see its transactions and timestamps, which confirms the node is serving data.
- Open the GraphQL interface and run a small query for a few fields, such as block height or recent transaction IDs.
- Compare a result in the explorer with the same result from GraphQL to check that both read the same node.
- Save your working queries in a text file so you can repeat them after restarts.
- Stop the stack cleanly when you finish, and keep an eye on disk usage since chain data grows over time.
Pros & cons
- Free and open source, with public code on GitHub
- Bundles a node, explorer and GraphQL interface in one Docker setup
- Lists Windows, Linux and Docker among its platforms
- Less manual wiring than assembling each component yourself
- A community fork by reqlez is available as an alternative
- The last code update was in April 2023, more than two years ago
- Windows support has not been formally verified
- Offers fewer configuration options than Ergo Bootstrap
- Requires working knowledge of Docker and containers
- Community-run project, so official support is not guaranteed
Is Ergo Setup safe?
Ergo Setup is a community project, and its last code update was in April 2023. That gap means you should be more careful than you would be with an actively maintained tool. Download only from the official GitHub repository, and avoid mirrors or repackaged archives. If the project publishes SHA-256 checksums or signed tags, compare them with your download before running anything. If none are published, read the Compose files and check which images they pull. This stack does not need a wallet seed phrase, and you should never enter one on a website that asks for it.
- Official source only. Download from github.com/abchrisxyz/ergo-setup. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Ergo Setup differs mainly in how much it packages for you. Ergo Bootstrap is the closest relative, and the project itself describes it as offering more options and being NixOS-based. If you want a simpler Docker route and do not mind fewer choices, Ergo Setup is the lighter path. The reqlez fork is a community alternative worth comparing if you want a different maintenance history. Among other catalog entries, Chainhook focuses on reorg-aware indexing for Stacks and Bitcoin, Cshtop visualizes Cosmos blocks in a terminal, and BX is a Bitcoin command line tool. Those are useful if your work centers on a different chain.
Specifications
- Price
- Free
- Type
- Open source
- License
- —
- Latest version
- —
- Last update
- 16 Apr 2023
- Windows support
- Unverified (Windows mentioned in docs)
- Source code
- github.com/abchrisxyz/ergo-setup
Frequently asked questions
Yes, Ergo Setup is free and open source. You can read its code on GitHub, and there is no listed price for the program itself. Your main costs will be disk space, bandwidth and the time it takes for the node to sync.
It can be used safely if you take basic precautions. Download only from the official GitHub repository, verify checksums or signed tags when available, and read the Compose files. Keep in mind that its last code update was in April 2023.
Windows is mentioned in the project documentation, but it has not been formally verified on the platform. The setup runs through Docker, so you need Docker Desktop with Compose working properly before you start. Expect some troubleshooting.
You need Docker with Docker Compose installed and running, plus enough free disk space and bandwidth for a full Ergo node. Basic familiarity with containers and configuration files helps a lot when something needs adjusting.
The project documentation names Ergo (ERG) as its supported network. The stack is built around one Ergo node, so it is aimed at that chain rather than at multiple blockchains.
Ergo Setup is a simpler Docker-based package with fewer options. Ergo Bootstrap offers more configuration choices and is built on NixOS. Pick Ergo Setup if you want a quicker start on Windows and can accept fewer settings.
The last code update in the repository is from April 2023, so active development appears to have slowed or stopped. Check the GitHub page for recent activity before relying on it for anything important.
Verdict
Ergo Setup is a reasonable choice for developers and analysts who want a local Ergo node, explorer and GraphQL interface bundled in one Docker setup. It is free, its code is public, and it saves time compared with assembling the parts yourself. It is less suitable for beginners who want a polished app, and its age means you should read the configuration closely. Before installing, check the latest version and activity on the official website.