# Introducing eRPC

> Source: https://docs.erpc.cloud/
> Format: machine-readable markdown export of the docs page above.
> All collapsible AI sections are inlined and fully expanded.

# Introducing eRPC

eRPC is a fault-tolerant EVM RPC proxy and permanent caching solution. It is built with read-heavy use-cases in mind such as data indexing and high-load frontend usage.

# Quick start

### Create configuration

Create your [`erpc.yaml`](/config/example.llms.txt) configuration file based on the `erpc.dist.yaml` file:

```bash
cp erpc.dist.yaml erpc.yaml
code erpc.yaml
```

See [a complete config example](/config/example.llms.txt) for inspiration.

### Run with Docker

Use the Docker image:

```bash
docker run -v $(pwd)/erpc.yaml:/erpc.yaml -p 4000:4000 -p 4001:4001 ghcr.io/erpc/erpc:latest
```

### Test the setup

Send your first request:

```bash
curl --location 'http://localhost:4000/main/evm/42161' \
--header 'Content-Type: application/json' \
--data '{
    "method": "eth_getBlockByNumber",
    "params": [
        "0x1203319",
        false
    ],
    "id": 9199,
    "jsonrpc": "2.0"
}'
```

### Setup monitoring (optional)

Bring up monitoring stack (Prometheus, Grafana) using docker-compose:

```bash
# clone the repo if you haven't
git clone https://github.com/erpc/erpc.git
cd erpc

# bring up the monitoring stack
docker-compose up -d
```

### Access Grafana

Open Grafana at [http://localhost:3000](http://localhost:3000) and login with the following credentials:

- username: `admin`
- password: `admin`

### Monitor metrics

Send more requests and watch the metrics being collected and visualized in Grafana.

![eRPC Grafana Dashboard](/assets/monitoring-example-erpc.png.llms.txt)