Migrate Your Subgraph From Alchemy to The Graph Network

Migrate or deploy an existing Subgraph to The Graph.

Overview

This guide walks you through:

1. Preparing your environment and source code
2. Building and testing locally with Graph Node Dev Mode (gnd)
3. Deploying to The Graph Studio.

1. Prerequisites

You’ll need:

• Your subgraph source code (subgraph.yaml, schema.graphql, src/mapping.ts)
• Node.js⁠, Yarn, and graph-cli:

  1npm install -g @graphprotocol/graph-cli

• A The Graph Studio account and access token

2. Install and Authenticate with CLI

Install and authenticate the CLI:

1npm install -g @graphprotocol/graph-cli2graph auth <YOUR_ACCESS_TOKEN>

3. Prepare and Build Your Subgraph

If you don’t already have a project, initialize one from a contract:

1graph init --from-contract <CONTRACT_ADDRESS> <SUBGRAPH_NAME>

Then build it:

1yarn codegen && yarn build

4. Test Locally with Subgraph Dev Mode

gnd lets you run a local Graph Node instance for rapid testing—no IPFS or manual database setup required.

Install gnd

1graph node install2gnd --version

Run Locally

From your subgraph directory:

1gnd --ethereum-rpc mainnet:http://localhost:<PORT> --watch

Query your subgraph at:
http://localhost:8000/subgraphs/name/subgraph-0/

1gnd --ethereum-rpc mainnet:http://localhost:<PORT> >     --postgres-url "postgresql://graph:yourpassword@localhost:5432/graph-node"

Common Flags | Flag | Description | |------|--------------| | --watch | Auto-redeploy when files change | | --postgres-url | Required on Windows | | --ethereum-rpc | RPC endpoint (required) |

5. Deploy to The Graph Network

After verifying locally, deploy your subgraph to Studio:

1graph deploy --studio <SUBGRAPH_SLUG>

This command publishes your Subgraph to The Graph Network via Studio.

6. Monitor and Manage Your Deployment

Access your Subgraph dashboard to view logs, indexing progress, and query endpoints:

Dashboard:
https://thegraph.com/studio/<subgraph-name>

List all Subgraph deployments:

1graph subgraph list

7. Update Your Application

Your subgraph’s GraphQL endpoint follows this format:

1https://api.studio.thegraph.com/query/{user_id}/{subgraph_slug}/{version}

Example:

1https://api.studio.thegraph.com/query/1234/my-subgraph/v1.0.0

Replace your old endpoint with this one in your dApp or backend configuration.

8. Verify Your Deployment

Run a quick test query:

1{2  transfers(first: 5) {3    id4    from5    to6    value7  }8}

Ensure results match your expectations.

9. Next Steps

• Monitor your subgraphs in Studio →
• Join The Graph community →⁠