Skip to main content

Troubleshooting

If you encounter errors or your full node stops working, run the commands in the following section to resolve the issue.

Issues during setup​

Error: cannot find -lpq​

If, during the compilation step, you receive a cannot find -lpq error, you are missing the libpq library. Use sudo apt-get install libpq-dev to install on Linux, or brew install libpq on MacOS. After you install on MacOS, create a Homebrew link using brew link --force libpq. For further context, reference the issue on Stack Overflow.

Error: Listener: Address already in use​

If you receive the following error:

panicked at error binding to 0.0.0.0:9184: error creating server listener: Address already in use (os error 98)

Update the metrics address in your fullnode.yaml file to use port 9180.

metrics-address: "0.0.0.0:9180"

Inspecting the state of a running node​

Looking at the logs for specific errors:

journalctl -u iota-node -f

Reinstalling the node from scratch​

If you continue to see issues, do the following steps:

To re-install your node from scratch, run the same script you used to install it:

NETWORK="testnet" bash -i <(curl -sSf https://raw.githubusercontent.com/iotaledger/iota/refs/heads/develop/setups/fullnode/systemd/setup.sh)
info

Re-use the same network (testnet, mainnet, devnet) your node is already running on.

Local RPC Connectivity Issues​

Update the json-rpc-address in the full node config to listen on all addresses:

sed -i 's/127.0.0.1/0.0.0.0/' fullnode.yaml
-json-rpc-address: "127.0.0.1:9000"
+json-rpc-address: "0.0.0.0:9000"