NOTE: This document is just a first draft and still under contruction.

Only use this software with funds you could afford to lose. Especially a lightning wallet that is a hot wallet, which has constant connection to the internet and can be target of exploitation.

Just because the software is OpenSource does not mean its free of errors. Especially if you run additional apps, the RaspiBlitz team cannot review all the code of those external projects.

The software is provided "AS IS", without warrenty of any kind. In no event shall the authors or copyright holders be liable for any claim, damages or other liability. details on legal license

Updates are made only for the latest version.

Security patches can be done with MAINMENU > UPDATE > PATCH for the current branch in the case of a high risk issue before next release.

The latest version always have the latest tag. To make sure you are using the lastest version, run:

curl -s https://api.github.com/repos/rootzoll/raspiblitz/releases/latest|grep tag_name|head -1|cut -d '"' -f4

To report security issues send an email to [email protected] (not for support).

The following keys may be used to communicate sensitive information to developers:

You can import a key by running the following command with that individual’s fingerprint:

curl https://keybase.io/rootzoll/pgp_keys.asc | gpg --import
curl https://keybase.io/oms/pgp_keys.asc | gpg --import

Ensure that you put quotes around fingerprints containing spaces if importing with other methods.

• Wi-fi and Bluetooth is disabled by default in the build script.
• UFW is active and only specific ports are open, closing ports and removing hidden services when services are uninstalled.
• Fail-2-Ban is protecting the SSH login against brute-force-attacks.
• Admin (and Joinmarket [optional]) users have passwordless sudo access to be able to perform installations and read password without much user interaction.

• The lightning wallet and user interfaces are password protected by default so this has more privacy implications (in the case of physical theft) than security.
• Optional log in through SSH using a hardware wallet.
• LUKS encryption would be welcome in the future.

Please keep in mind that there can be two different on-chain wallets on the RaspiBlitz:

The default is the on-chain lightning wallet - that's the wallet where you normally send your funds before opening a channel & where your funds return to when you close a channel. With the initial word seed you get during RaspiBlitz setup, you can get access again to this on-chain wallet. Keep the seed words secure in a off-line location.

Beside lightning you have a bitcoin core installed. Normally, bitcoin core acts just as a blockchain informational service to the lightning wallet and its internal seperate on-chain wallet is deactivated.

Some apps (like Fully Noded or JoinMarket) activate the bitcoin core wallet and use it for their own needs. This on-chain balance will not be reflected in the rest of the RaspiBlitz software and is NOT backuped by the seed words from the RaspiBlitz setup. If you make use of the bitcoin core wallet please take care of these funds.

Please note that there is no perfect backup concept for the funds in your lightning channels yet. We strongly recommend using the Static Channel Backup provided by LND and consider off-line location backup of that file to have the best chances to recover Lightning funds in a case of recoverying from a disaster.

For more practical information on this topic see: Backup Channel Funds