| name | taiko-node |
| description | Set up, run, and manage Taiko nodes on Hoodi testnet or mainnet using Docker or from source. Use when "run node", "node operator", "simple-taiko-node", "taiko-geth", "taiko-client", or "sync" is mentioned. |
Taiko Node Operations
Run Taiko nodes. A node = taiko-geth (execution) + taiko-client (consensus).
Network Selection: Always ask which network if user hasn't specified "hoodi" or "mainnet".
Quick Decision Guide
Prerequisites
- Hardware: 16 GB RAM, 2 TB SSD, quad-core CPU
- Software: Docker
^24.0, git ^2 (source: also Go ^1.21, make ^4)
- L1 node required — local strongly recommended (remote RPCs rate-limit)
Quick Start (Docker)
git clone https://github.com/taikoxyz/simple-taiko-node.git && cd simple-taiko-node
cp .env.sample .env
docker compose up -d
docker compose -f docker-compose-hoodi.yml up -d
L1 endpoints: Use host.docker.internal or machine's private IP, not 127.0.0.1.
CLI Quick Reference
Use taiko --json for structured output:
taiko node status --json
taiko node logs --service taiko_client_driver --tail 50
taiko node logs --service l2_execution_engine --tail 50
taiko node restart --json
All commands return: { schema_version, command, status, network, data, errors, warnings, metrics }
Related Skills
Resources