# Erigon Rpcdaemon Run

> Use to run standalone Erigon RpcDaemon on an existing datadir. Use when the user wants to exercise the `rpc-tests` binaries (`rpc_int`, `rpc_perf`) against real server.

- Skill: `erigontech/erigon-rpcdaemon-run` (Agent Skill)
- Install (CLI): `npx skillmds@latest add erigontech/erigon-rpcdaemon-run`
- Raw SKILL.md: https://api.skillmd.com/api/skills/erigontech/erigon-rpcdaemon-run/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: erigontech (https://skillmd.com/u/erigontech)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/erigontech/erigon-rpcdaemon-run

---


# Erigon RpcDaemon Run

## Overview
The `rpcdaemon` command runs standalone RpcDaemon on an existing Erigon datadir.

## Command Syntax

```bash
cd <erigon_home> && ./build/bin/rpcdaemon --datadir=<path> --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws [other-flags]
```

## Required Flags

- `--datadir`: Path to the Erigon datadir (required)

## Usage Patterns

### Change HTTP port
```bash
cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --http.port=8546
```

### WebSocket support
```bash
cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --ws
```

### GraphQL support
```bash
cd <erigon_home_path> && ./build/bin/rpcdaemon --datadir=<datadir_path> --graphql
```

## Important Considerations

### Before Running
1. **Ask for Erigon home**: Ask the user which Erigon home folder to use if not already provided
2. **Stop Erigon and RpcDaemon**: Ensure Erigon and/or RpcDaemon are not running on the target datadir
3. **Ensure RpcDaemon binary is built**: run `make rpcdaemon` to build it

### After Running
1. Wait until the HTTP port (value provided with --http.port or default 8545) is reachable


## Workflow

When the user wants to run Erigon RpcDaemon:

1. **Confirm parameters**
    - Ask for Erigon home path to use if not provided or know in context
    - Ask for target datadir path

2. **Safety checks**
    - Verify Erigon home <erigon_home_path> exists
    - Verify datadir <datadir_path> exists
    - Check if Erigon and/or RpcDaemon are running (should not be)


## Error Handling

Common issues:
- **"datadir not found"**: Verify the path is correct
- **"database locked"**: Stop Erigon process first


## Examples

### Example 1: All API namespaces and WebSocket enabled
```bash
cd ../erigon_devel && ./build/bin/rpcdaemon --datadir=~/Library/erigon-eth-mainnet --http.api admin,debug,eth,parity,erigon,trace,web3,txpool,ots,net --ws
```


## Tips

- If building from source, use `make rpcdaemon` within <erigon_home_path> to build the binary at `build/bin/rpcdaemon`