Skip to content

Running a 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.

The information presented herein is for informational purposes only and has been provided by third parties. Moonbeam does not endorse any project listed and described on the Moonbeam docs website (

Checking Prerequisites

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

In this guide, you will learn how to run a Graph node against a Moonbase Alpha tracing node with the tracing flag enabled. To spin up a full node with the tracing flag enabled, check out the Debug & Trace guide.

This guide can also be adapted for Moonbeam and Moonriver. To test out the examples in this guide on Moonbeam or Moonriver, you will need to have your own endpoint and API key, which you can get from one of the supported Endpoint Providers.

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: 'moonbeam:'
ethereum: 'moonriver:'
ethereum: 'mbase:'
ethereum: 'mbase:'

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:'
      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 for Moonbeam and Moonriver as well.

The information presented herein has been provided by third parties and is made available solely for general information purposes. Moonbeam does not endorse any project listed and described on the Moonbeam Doc Website ( Moonbeam Foundation does not warrant the accuracy, completeness or usefulness of this information. Any reliance you place on such information is strictly at your own risk. Moonbeam Foundation disclaims all liability and responsibility arising from any reliance placed on this information by you or by anyone who may be informed of any of its contents. All statements and/or opinions expressed in these materials are solely the responsibility of the person or entity providing those materials and do not necessarily represent the opinion of Moonbeam Foundation. The information should not be construed as professional or financial advice of any kind. Advice from a suitably qualified professional should always be sought in relation to any particular matter or circumstance. The information herein may link to or integrate with other websites operated or content provided by third parties, and such other websites may link to this website. Moonbeam Foundation has no control over any such other websites or their content and will have no liability arising out of or related to such websites or their content. The existence of any such link does not constitute an endorsement of such websites, the content of the websites, or the operators of the websites. These links are being provided to you only as a convenience and you release and hold Moonbeam Foundation harmless from any and all liability arising from your use of this information or the information provided by any third-party website or service.
Last update: May 10, 2024
| Created: April 21, 2021