> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sqd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 120+ networks.
> To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines.
> To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp.
> Every page on this site is available as Markdown by appending .md to its URL.

# Local EVM Devnet Setup

> Introduction to running a local EVM devnet indexing stack.

Index your local devnet data and query it using the Portal API. This setup allows you to run a complete indexing stack on your machine using Docker.

## What This Provides

A local deployment that:

* Ingests blockchain data from your RPC endpoint
* Stores blocks with full transaction details, receipts, traces, and state diffs
* Exposes the Portal API for querying your local chain data
* Works with any EVM-compatible devnet or testnet

## Prerequisites

Before starting, ensure you have:

* **Docker** and **Docker Compose** installed on your system
* Access to an **EVM RPC endpoint** (local devnet or testnet URL)
* **Sufficient disk space** - the setup stores the entire blockchain locally

<Note>
  For production devnets with significant block history, allocate at least 50GB of disk space initially and monitor growth.
</Note>

## Architecture

The setup runs two Docker services:

### hotblocks-service

Connects to your RPC endpoint and fetches blockchain data including:

* Block headers and transactions
* Transaction receipts
* Execution traces
* State diffs

### hotblocks-db

Stores the blockchain data and provides:

* Portal API query interface on port 8000
* Efficient data retrieval and filtering
* Same API as the public SQD network

## Next Steps

Continue to the [Configuration](/en/data/evm-local-setup/configuration) page to set up your Docker services.


## Related topics

- [Usage](/en/data/evm-local-setup/usage.md)
- [Solana Devnet](/en/data/solana/solana-devnet.md)
- [Soon Devnet](/en/data/solana/soon-devnet.md)
- [Private Portal setup](/en/portal/self-hosting.md)
- [Index to local CSV files](/en/sdk/squid-sdk/evm/examples-tutorials/file-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.