PerformanceBlog
Tempo MCP serverGive agents search and read tools for Tempo docs
Skip to content
LogoLogo

tempo node

Run a Tempo node. For faster initial sync, first download a snapshot with tempo download. For operational setup guides — system requirements, systemd configs, monitoring, validator onboarding — see Run a Tempo Node.

Flags grouped by function:

Network

FlagDescription
--followRun as a full node following a trusted RPC endpoint
--chain <network>Target network (mainnet, moderato)
--datadir <path>Data directory for chain state

RPC server

FlagDescription
--httpEnable the JSON-RPC HTTP server
--http.port <port>JSON-RPC port (default: 8545)
--http.addr <addr>JSON-RPC bind address
--http.api <apis>Enabled API namespaces (e.g., eth,net,web3,txpool,trace)

Consensus (validators)

FlagDescription
--consensus.signing-key <path>Path to validator signing key
--consensus.secret <path>Path to the secret used to decrypt an encrypted validator signing key. Prefer a named pipe (FIFO) or shell process substitution.
--consensus.fee-recipient <addr>Deprecated validator fee-recipient flag. Migrate to on-chain fee-recipient management via Validator Config V2.
--consensus.datadir <path>Separate volume for consensus data

Observability

FlagDescription
--telemetry-url <url>Unified metrics and logs export endpoint
--telemetry-metrics-interval <dur>Metrics push interval (default: 10s)
--metrics <port>Enable Prometheus metrics on this port

tempo node examples

Download a snapshot and start an RPC node:

tempo node \
  --follow \
  --http --http.port 8545 \
  --http.api eth,net,web3,txpool,trace

Start a validator:

tempo node --datadir /data/tempo \
  --chain mainnet \
  --consensus.signing-key /etc/tempo/key \
  --consensus.secret /run/tempo/consensus-secret \
  --consensus.fee-recipient 0x...

Learn more about Tempo node operations