Skip to content

Run a Node

Production nodes are the backbone of the network. Use Docker for speed or run the native service for deeper control.

Quickstart (Docker)

animica node up
animica node status
animica peer list

Default RPC: http://127.0.0.1:8545/rpc

Native install

source .venv/bin/activate
python -m core.boot --genesis core/genesis/genesis.json

See docs for full boot sequence.

Required ports

  • P2P: 30333 (TCP/QUIC)
  • RPC: 8545 (HTTP JSON-RPC)
  • WS: 8545/ws (WebSocket subscriptions)
  • Metrics: 9000 (optional)

Troubleshooting

  • Verify P2P ports are open and reachable.
  • Confirm seeds via ANIMICA_P2P_SEEDS if peer count stays 0.
  • Check logs: animica node logs --tail 50.

Need the full guide?

The docs include config files, security, and monitoring.

Read node operations docs →