Troubleshooting

Troubleshooting

If you are facing issues with your node/farmer you can try a few of the following things below, if you are unable to get your issue resolved please check our Forums to see if your issue may have been solved, if its a new one feel free to post it! You can also join our Discord for additional Peer to Peer help.

備考

We have included a few tutorials below that may help you in your support journey, this is not an all inclusive list but we welcome contributions

Wipe & Purge

If you were running a node previously, and want to switch to a new snapshot, please perform these steps and then follow the guideline again:

# Replace `FARMER_FILE_NAME` with the name of the farmer file you downloaded from releases
./FARMER_FILE_NAME wipe PATH_TO_FARM
# Replace `NODE_FILE_NAME` with the name of the node file you downloaded from releases
./NODE_FILE_NAME purge-chain --chain gemini-3g

Does not matter if the node/farmer executable is the previous one or from the new snapshot, both will work :) The reason we require this is, with every snapshot change, the network might get partitioned, and you may be on a different genesis than the current one. In plain English, these commands are like a reset button for snapshot changes.

Now follow installation guide.

Docker Wipe & Purge

In case of Docker setup run docker compose down -v (and manually delete custom directories if you have specified them).

Now follow installation guide.

If you are having some issues with running the node or the farmer for the subspace network, feel free to join our Discord or even better you can take a look at our Forums and review and existing questions or post a new one if needed!

- Forums

- Discord

Enable Rust Backtrace

When running the Subspace Network Farmer & Node, you might encounter an error message indicating the need for a Rust backtrace to diagnose issues:

Backtrace omitted. Run with RUST_BACKTRACE=1 environment variable to display it.

This message suggests that Rust, the programming language used in Subspace Network Farmer & Node, has encountered a problem. By default, the backtrace is not displayed. To enable the RUST_BACKTRACE environment variable and view detailed error information, use the following commands based on your operating system:

• 🖼️ Windows (PowerShell): Enter $Env:RUST_BACKTRACE=1 in PowerShell and rerun the application.
• 🍎 macOS: Type export RUST_BACKTRACE=1 in the terminal and rerun the application.
• 🐧 Ubuntu: Enter export RUST_BACKTRACE=1 in the terminal and rerun the application.
• ⚙ Service (Linux): For services, use sudo systemctl edit subspace-node or sudo systemctl edit subspace-farmer, add [Service] and Environment=RUST_BACKTRACE=1 between the warning comments, reload with sudo systemctl daemon-reload, and restart services using sudo systemctl restart subspace-{node,farmer}.

By enabling RUST_BACKTRACE, you can obtain additional diagnostic information to help resolve any errors encountered during operation.

Common Problems

Looking for solutions to other common issues?

Check out our Common Problems page. This resource covers a range of frequently encountered challenges, offering practical solutions to help you overcome them. Please note that while this page addresses many common issues, it is not an all-inclusive list. For issues not covered, you can visit our forums or Discord for additional support.