1. Node Will Not Start

Symptoms:

RTNC Core exits immediately or shows an error dialog.

Check:

debug.log

in your RTNC data directory.

Disk space (are you out of space?).

File permissions on the data directory.

2. Node Cannot Connect to Peers

Symptoms:

Zero peers, chain not syncing.

Check:

Is your firewall blocking outgoing connections?

Are you accidentally running with regtest/testnet flags when you meant mainnet?

Use

rtnc-cli getnetworkinfo

to see connection details.

3. Node Stuck Syncing

Symptoms:

Progress bar or block height does not move.

Check:

Network connectivity (Wi-Fi drop, router issues).

Disk I/O (slow or failing drive).

debug.log

for repeated error messages.

4. Wallet Not Showing Expected Balance

Symptoms:

You received RTNC but wallet shows zero.

Check:

Is your node fully synced to the latest block?

Did you restore the correct wallet or seed?

Verify the transaction in an explorer once one exists.

5. Mining Does Nothing

Symptoms:

Miner runs but no blocks found, no block results.

Check:

Are you on mainnet, testnet, or regtest? Regtest is best for “instant results”.

Is your hashrate extremely low compared to network difficulty?

Is your miner actually connected to your node’s RPC or to a valid pool?

6. RPC Errors

Symptoms:

Commands like

rtnc-cli getblockchaininfo

fail.

Check:

Is the node running with

server=1

in

rtnc.conf

?

Is the CLI pointed at the right data directory or network (mainnet/testnet/regtest)?

Are RPC user/password and port correct?

7. Regtest or Testnet Confusion

Symptoms:

Balances differ, block heights do not match expectations.

Check:

Use

getblockchaininfo

and look for

"chain"

field.

Do not reuse the same wallet files between mainnet and test networks.

8. Where to Look for More Detail

Log files:

Usually the first and best source of truth.

Command help:

rtnc-cli help

and

rtnc-cli help <command>

.

Docs:

Node & Mining Quickstart, Testnet Setup, and Developer Overview.