Menu

Caution

You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at 0.3.5.x.

BlueWallet

Note

This guide assumes you have already setup LNbits as per this guide with LND as your underlying node.

Warning

This will not work with CLN as your underlying node!

  1. Bluewallet requires that we use the LnbHub extension in order to connect to LNbits.

  2. To do this, click Manage Extensions:

    manage-extensions
  3. Click MANAGE under the LndHub extension:

    lndhub-manage
  4. Click the two arrows on the right, then click install:

    arrows-install
  5. Now ensure that it says Activated underneath LndHub and then click Extensions on the left:

    activated-click-extensions
  6. Click ENABLE:

    extensions-enable
  7. Click OPEN or LndHub under Extensions:

    lndhub-open
  8. Make sure the wallet you just created is selected below the two QR codes:

    lndhub-select-wallet
  9. Open up BlueWallet and click on the three dots in the top right:

    ../../../_images/bluewallet-three-dots.jpg
  10. Click “Network” then “Tor settings”:

    ../../../_images/bluewallet-network.jpg
    ../../../_images/bluewallet-tor-settings.jpg
  11. Click “Start” and it should say “Done” after a short time:

    ../../../_images/bluewallet-tor-start.jpg
    ../../../_images/bluewallet-tor-done.jpg
  12. Head back to the main screen and click the “+” sign:

    ../../../_images/bluewallet-add-wallet.jpg
  13. Click “Import wallet”:

    ../../../_images/bluewallet-plus.jpg
  14. Click “Scan or import a file”

    Note

    Screenshots not possible for this step!

  15. If you only want this wallet to be able to RECEIVE PAYMENTS, scan this QR code:

    left-qr

    If you are happy for this wallet to be able to both receive and MAKE payments scan this QR code:

    right-qr
  16. You’ll see this once the wallet is added:

    bluewallet-with-funds
  17. In addition to allocating sats to this wallet via the LNbits Superuser Account (see “Funding LNbits section” here), you can also receive funds the normal way by hitting “Receive” within BlueWallet.

    blue-wallet-receive

    Note

    Funds received this way must be sent from another lightning node, not the LND node underneath LNbits. A lightning payment that originates and terminates at the same node is technically a rebalance, not a normal payment.

Congratulations! BlueWallet is set up and ready to use lightning via your own lightning node - furthermore it will only be able to use your node in the way you allow it, via LNbits.