mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 02:11:55 +00:00
d0091a1c10
* skeleton guide for lnbits/zeus * almost finished * almost finished * typos * final edits for review * rewording * change format to be just lnbits with two tabs (zeus/alby), update to new LNbits UI * begin adding blue wallet, rework everything else * add blue wallet words * add bluewallet pictures * alby guide * finish up alby * wording * formatting * mention firefox/tor for alby guide * make each integration its own page * . * reorder everything, rewriting as necessary * zeus LNC guide * more lnc stuff * almost done, just waiting for new alby * new alby guides, tweaks * everything except Zap * . * reorder * deeper tree * zap * davids suggestions * fix alignment * more formatting errors * . * . * fix build errors * rename bluewallet header in bitcoin doc * capitalize a word, remove quotes from bold stuff * add alts for images * davids changes
64 lines
3.4 KiB
ReStructuredText
64 lines
3.4 KiB
ReStructuredText
.. _connecting-lnbits:
|
|
|
|
======
|
|
LNbits
|
|
======
|
|
|
|
The concept
|
|
-----------
|
|
|
|
LNbits allows you to create a wallet that makes use of your node with only an alloted amount of sats. This restriction can be very helpful for if you only want to have a small amount for spending on your phone without making your entire lightning balance available. You can even allow other people to have wallets you create for them - think giving your children an allowance. They can start with a set amount (can be zero) and simply spend what you initially make available. They can also earn more for themselves as they will have the freedom to issue their own invoices - all while making use of your node.
|
|
|
|
.. tip:: All wallets created this way are ultimately bound by the capacity of your node. If one wallet is allocated 10,000 sats but your underlying node only has 9000 sats of outbound capacity, payments will simply fail.
|
|
|
|
What lightning node should I use?
|
|
---------------------------------
|
|
|
|
This will work for both **Core Lightning (CLN)** and **LND** *but* if you want to connect :ref:`Zeus<zeus-lnbits>` or :ref:`BlueWallet<blue-wallet>` to LNbits then **this will only work with LND** as the underlying node. This is because the LNDhub plugin will be required.
|
|
|
|
If you are looking to connect the `Alby <https://github.com/getAlby/lightning-browser-extension#installation>`_ browser extension to your LNbits wallet, that will work with **both CLN** *and* **LND**.
|
|
|
|
Setting up LNbits
|
|
-----------------
|
|
|
|
.. note:: You will need a Tor enabled browser. We suggest using Firefox which will need to have been setup to use Tor - if you have yet to do this please see our guide :ref:`here<tor-firefox>`. This also requires having :ref:`native tor setup<tor-os>`.
|
|
|
|
#. Start by ensuring that you have LNbits installed already as well as LND or Core Lightning (CLN). You also need your lightning node to have at least one channel set up otherwise payments will not work. If you have not set up a channel yet, please follow :ref:`this guide<lightning-intro>`.
|
|
|
|
.. figure:: /_static/images/services/lnbits/lnbits-lnd-cln-installed.png
|
|
:width: 40%
|
|
:alt: lnbits-lnd-cln-installed
|
|
|
|
.. tip:: Remember - if you intend to connect BlueWallet or Zeus, that will only be possible with LND. Alby can work with both.
|
|
|
|
#. Head to LNbits on your server, click on **Properties** and copy the address under **(Tor) Superuser Account**:
|
|
|
|
.. figure:: /_static/images/services/lnbits/tor-super-user.png
|
|
:width: 40%
|
|
:alt: tor-super-user
|
|
|
|
#. Paste this address into your browser and you'll see the following screen - click **I understand**:
|
|
|
|
.. figure:: /_static/images/services/lnbits/superuser-first-open.png
|
|
:width: 60%
|
|
:alt: superuser-first-open
|
|
|
|
.. note:: This isn't a concern on StartOS as all wallets created will have the address they generated stored within **Properties** within the LNbits serivce.
|
|
|
|
#. Now a default wallet will have already been generated - highlighted on the top left. We'll rename it by clicking **Rename wallet** entering **android-zeus-wallet** then clicking **UPDATE NAME**:
|
|
|
|
.. figure:: /_static/images/services/lnbits/rename-default-wallet.png
|
|
:width: 60%
|
|
:alt: rename-default-wallet
|
|
|
|
.. note:: I have called the wallet "android-zeus-wallet" but it is fine to use other wallets.
|
|
|
|
Now you can proceed to connect one of the following wallets to LNbits using the guides below:
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
alby-lnbits
|
|
bluewallet
|
|
zeus-lnbits
|