Install Indexing Service Locally

SubQuery TeamAbout 1 min

Install Indexing Service Locally


If you are a beginner, installing the Indexing service locally via Docker is preferred.

Docker is used to make the installation process as simple as possible as it maintains consistency and integrity.

The process includes obtaining the docker-compose.yml file and then starting the container. This can be done in 2 ways:

  1. On your own computer or “localhost”
  2. On a cloud provider such as AWS

Now, let's explore how to run the Indexing Service Locally step-by-step.

Initial Preparation

Step 1 - Download the Indexer Service file

  • Donwloand indexing services docker-compose.yml file to you machine, which consists of all the images to build and start the various applications.
mkdir subquery-indexer && cd subquery-indexer
curl -o docker-compose.yml


DO NOT skip checking the indexer version after you finish the installation process. Visit this section to check the latest indexer version is used and to to complete the set up process.

Also, please change the default PostgreSQL password in the POSTGRES_PASSWORD field and in the coordinator-service's postgres-password field in the docker-compose.yml file.

Step 2 - Start the Indexing Service

Run the following command to start the Indexing service:

docker-compose up -d

Please check that the Docker is already running. The images will be pulled from Docker and then it will start the following services:

  • indexer_db
  • indexer_coordinator
  • indexer_proxy
  • indexer_cache

docker compose-up command line

Step 3 - Open the Indexer Admin Page

Open http://localhost:8000/ in your browser and you will get to see:

Indexer Admin Page - Asking to Connect with Metatask

Next Steps

You have successfully installed and started the Indexer Service locally.

We highly recommend setting up SSL on your new server. Follow the guide here.

You can also move forward to connect with MetaMask.


Having trouble running a command or setting up the service? Got stuck in the process? Find your solutions here.