For the complete documentation index, see llms.txt. This page is also available as Markdown.

Useful Commands

Testnet · v0.16.5 · Chain ID 10143

Daily checks for the packaged Monad installation. Use Node Upgrade when changing the installed release.

Service operations

Service status

Confirm consensus, execution and RPC are active.

sudo systemctl status monad-bft monad-execution monad-rpc --no-pager -l

Start services

Start all three node components.

sudo systemctl start monad-bft monad-execution monad-rpc

Stop services

Stop all three components before maintenance.

sudo systemctl stop monad-bft monad-execution monad-rpc

Restart services

Restart the packaged services after an approved configuration change.

Enable startup

Enable the services at boot.

Follow consensus logs

Ctrl+C exits the log view without stopping the service.

Follow execution logs

Inspect execution progress and errors.

Follow RPC logs

Inspect requests, startup and RPC errors.

Check cleanup timer

Confirm periodic artifact cleanup is enabled.

Version and package

Binary version

Expect v0.16.5 and commit 33d9d5c0314eff8c6409a810b9dbf1b6381c6b5c.

Package version

Compare the installed package with available repository versions.

Hold the package

Prevent an unattended change to a release intended for another network.

Network and synchronization

RPC becomes available after statesync. Compare block progress with an independent Testnet endpoint.

Check chain ID

Expect 0x279f, which is 10143.

Check block height

Repeat after a short interval to confirm advancement.

Inspect listening ports

Check consensus ports 8000–8002, RPC 8080 and monitoring ports. Keep RPC and metrics restricted.

v0.16.5 configuration checks

Packaged installs already use /dev/triedb. Custom launchers must pass the device itself, not a directory containing it.

Inspect effective units

Review base units and any local overrides.

Check TrieDB paths

Inspect every matching argument; check custom launchers separately if no match appears.

Resolve the device

Confirm the symlink targets the intended database partition.

Check metrics-file arguments

Execution's --db-stats-file and consensus's --triedb-stats-path must refer to the same path. Packaged units use /home/monad/monad-bft/triedb-stats.

Monitoring

Read native metrics

The native endpoint defaults to port 9143. Restrict it to monitoring clients.

Existing collector setups may still expose port 8889. Follow the separate metrics migration announcement before removing a collector; the upstream page currently asks operators to wait for Foundation approval.

Recovery

Workspace resets and snapshot restoration discard or replace local state. They are recovery procedures, not routine v0.16.5 upgrade steps. Preserve configuration and identity keys, stop the node and follow the relevant official instructions. The fresh-node installation guide describes Testnet bootstrap for a new server.

Official release instructions · Node Upgrade

Last updated