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 Node & Farmer
Occasionally after updating to a new version of the Pulsar you will need to wipe your node and farmer, generally this should not be required but can be attempted if your farmer is having issues after having had worked fine previously.
To simply restart the node, go to the terminal where you started the farm command, and press Ctrl + C you should see a shutdown message appear and the application will attempt a simple shutdown, if you dont see the message press Ctrl + C again to force shutdown. You can then simply start the farmer again with the farm command you used prior.
Use the same file name as the previous init and farm steps, then add the wipe command to free the previous storage that was being used. Generally, only do this if you have severe errors and are prompted by a staff member.
./pulsar-file-name wipe
After wiping, follow the init and farm steps above to start farming again!
View your Logs
A good place to start if you are facing trouble is by viewing your logs and seeing if there are any errors or insights that might be available. You can find the location for your logs below:
- 🖼️ Windows:
%USERPROFILE%/AppData/Local/pulsar/logs - 🍎 macOS:
$HOME/Library/Logs/pulsar/ - 🐧 Ubuntu:
$HOME/.local/share/pulsar/logs
Enable Rust Backtrace
When running the Subspace Network Farmer & Node, sometimes you may encounter an error message that includes a line similar to the following:
Backtrace omitted. Run with RUST_BACKTRACE=1 environment variable to display it.
This error message means that Rust (the programming language that Subspace Network Farmer & Node is written in) has encountered a problem and has provided a diagnostic backtrace that can help diagnose the issue. However, by default, the backtrace is not displayed. To see the backtrace, you need to enable the RUST_BACKTRACE environment variable.
To enable the RUST_BACKTRACE enter the following into your terminal:
- 🖼️ Windows(PowerShell):
$Env:RUST_BACKTRACE=1 - 🍎 macOS:
export RUST_BACKTRACE=1 - 🐧 Ubuntu:
export RUST_BACKTRACE=1
Once you have enabled the RUST_BACKTRACE simply rerun the application and you will get additional info upon any errors.
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.