The final resolution of Error: Invalid or corrupt peers.dat

After completing these steps be sure to update your Bitcoin Node app to 25.0

Bitcoin Core is what Bitcoin Node is using, and this was fixed after version 24.0.1 and should no longer occur!

After having issues syncing Bitcoin and then checking your debug logs you may see a line that shows up like this:

"Error: Invalid or corrupt peers.dat (Checksum mismatch, data corrupted)"

Here are the steps to follow to delete the peers.dat and restart Bitcoin,

Connect to your Umbrel by following the instructions in the Official FAQ under How to SSH into Umbrel on a Raspberry Pi or by accessing a terminal on your Linux machine :

Then stop Bitcoin:

~/umbrel/scripts/app stop bitcoin

Then you can delete the peers.dat file:

rm /home/umbrel/umbrel/app-data/bitcoin/data/bitcoin/peers.dat

(If the above command works it just sends you to the new line, sometimes this is confusing but that means it was successful otherwise if you run it again you’ll see it now displays “No such file or directory”)

Then start Bitcoin again:

~/umbrel/scripts/app start bitcoin

Then please wait at least ~5 minutes, it can sometimes take a little longer.

Now finally reload your dashboard and you will likely see your Bitcoin Node app has begun to synchronize once more, hopefully closer to 99% and only take a few hours to finish.

Now all your apps will work normally again, including Lightning Node, and this also should fix any errors with your Lightning Node apps appearing with the wallet locked error as well once Bitcoin Node app is done resynchronizing

If you are curious on why this error may had been occurring, it was a known bug in Bitcoin 24.0.1 and earlier.

And this is more context here for some of the fixes and where it was merged if you’re curious why this was happening: