OPERATORS / 04
Find the next
useful signal.
Start with the observable symptom. Preserve enough context to distinguish configuration, connectivity, storage, and protocol failures.
Historical source snapshot. Source links point to commit 5af188d; text was reviewed 14 November 2026 and may differ from newer client builds.
The build fails
Confirm the pinned toolchain, platform prerequisites, repository access, and the exact command. Record the first build error and commit SHA. A private-repository access failure needs authorization, not a different compiler.
The node has no peers
Confirm the network, bootnode file, address reachability, and the configured P2P ports. For Rust Apothem, use ops/bootnodes/apothem.txt from the same checkout; there is no built-in boot list in the documented setup.
The head stops advancing
Inspect peer connectivity and the first rejected block. Record height, hash, network, build SHA, and the first error. Compare the block with an independent reference. Preserve the data directory before attempting recovery.
RPC responds but data looks wrong
Check eth_chainId, eth_blockNumber, and eth_syncing. Then verify the exact method and transport against the compatibility matrix. A working TCP connection does not prove complete API support.
Disk use or memory keeps growing
Record block range, retention mode, state mode, database size, process RSS, and file-backed memory. Compare like-for-like samples. Follow the storage guide before changing retention or deleting historical data.
The node cannot reopen its data
Capture the precise error and the previous binary version. Schema, checkpoint, or history-table changes can make an old directory incompatible. Use the version-specific upgrade and rollback instructions.
Reviewed 14 November 2026. Repository guides hold the current implementation details.
KEEP THE CURIOSITY GOING
Another way in.
Edit this page on GitHub opens the data definition (data/site-pages.js). GitHub may ask you to sign in. Report a correction opens a prefilled GitHub issue for this page.