Skip to content

Running a Graph Node on Moonbeam

The Graph Node on Moonbeam


A Graph Node sources events from a blockchain to deterministically update a data store that can be then queried via a GraphQL endpoint.

There are two ways you can set up a Graph Node: you can use Docker to run an all-in-one image, or you can run their Rust implementation. The steps described in this guide will only cover the Docker alternative, as it is more convenient, and you can set up a Graph Node very quickly.


The steps described in this guide have been tested in both Ubuntu 18.04-based and MacOs environments, and they will need to be adapted accordingly for other systems.

Checking Prerequisites

Before diving into setting up a Graph Node, you neeed to have the following installed on your system:

In addition, you need to have a node running with the --ethapi=trace option enabled. Currently, you can spin up two different kinds of nodes:

  • Moonbeam development node — run your own Moonbeam instance in your private environment. To do so, you can follow this guide. Make sure to check the advanced flags section
  • Moonbase Alpha node — run a full node of the TestNet and access your own private endpoints. To do so, you can follow this guide. Make sure to check the advanced flags section

In this guide, a Graph Node runs against a Moonbase Alpha full node with the --ethapi=trace flag.

Running a Graph Node

The first step is to clone the Graph Node repository:

git clone \
&& cd graph-node/docker

Next, execute the file. This will pull all the necessary Docker images and write the necessary information in the docker-compose.yml file.


The tail end from the logs of the previous command should look something similar to:

Graph Node setup

Once everything is set up, you need to modify the "Ethereum environment" inside the docker-compose.yml file, so that it points to the endpoint of the node you are running this Graph Node against. Note that the file detects the Host IP and writes its value, so you'll need to modify it accordingly.

ethereum: 'mbase:http://localhost:9933'

The entire docker-compose.yml file should look something similar to:

version: '3'
    image: graphprotocol/graph-node
      - '8000:8000'
      - '8001:8001'
      - '8020:8020'
      - '8030:8030'
      - '8040:8040'
      - ipfs
      - postgres
      postgres_host: postgres
      postgres_user: graph-node
      postgres_pass: let-me-in
      postgres_db: graph-node
      ipfs: 'ipfs:5001'
      ethereum: 'mbase:http://localhost:9933'
      RUST_LOG: info
    image: ipfs/go-ipfs:v0.4.23
      - '5001:5001'
      - ./data/ipfs:/data/ipfs
    image: postgres
      - '5432:5432'
    command: ["postgres", "-cshared_preload_libraries=pg_stat_statements"]
      POSTGRES_USER: graph-node
      POSTGRES_PASSWORD: let-me-in
      POSTGRES_DB: graph-node
      - ./data/postgres:/var/lib/postgresql/data

Lastly, to run the Graph Node, just run the following command:

docker-compose up

Graph Node compose up

After a while, you should see logs related to the Graph Node syncing with the latest available block in the network:

Graph Node logs

And that is it! You have a Graph Node running against the Moonbase Alpha TestNet. Feel free to adapt this example to a Moonbeam development node as well.