Files
documentation/site/source/guides/service-guides/lightning/zeus-lnbits.rst
kn0wmad 09b61c7e33 Big refactor, many minor fixes (#441)
* Big refactor, many minor fixes

* Link fixes, icon edits

* Index and ToC fixes

* update icons in theme lib and add to device guides index

* WIP - refactor Initial setup, LAN, FF, others

* First draft ready, many fixes and edits

* Ooops - minor edits and changes on initial setup

* Add change password guide (try 2).

* Remove change password menu item from guides

* Fix display bug, think different

---------

Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com>
Co-authored-by: gStart9 <george@start9labs.com>
2023-07-28 12:02:43 -06:00

125 lines
4.3 KiB
ReStructuredText

.. _zeus-lnbits:
Zeus
----
.. note:: This is not the same as connecting Zeus directly to your lightning node - using LNbits allows us to allocate a specific amount of funds to Zeus instead of giving it full access to your lightning node. We can also use LNbits to permit Zeus to **just receive** satoshis, or the ability to both **receive and spend** satoshis.
.. note:: This guide assumes you have already setup LNbits as per :ref:`this guide <connecting-lnbits>` with **LND** as your underlying node.
.. warning:: **This will not work with CLN as your underlying node!**
#. Zeus requires that we use the LnbHub extension in order to connect to LNbits.
#. To do this, click **Manage Extensions**:
.. figure:: /_static/images/services/lnbits/manage-extensions.png
:width: 50%
:alt: manage-extensions
#. Click **MANAGE** under the LndHub extension:
.. figure:: /_static/images/services/lnbits/lndhub-manage.png
:width: 40%
:alt: lndhub-manage
#. Click the two arrows on the right, then click install:
.. figure:: /_static/images/services/lnbits/arrows-install.png
:width: 40%
:alt: arrows-install
#. Now ensure that it says **Activated** underneath LndHub and then click **Extensions** on the left:
.. figure:: /_static/images/services/lnbits/activated-click-extensions.png
:width: 40%
:alt: activated-click-extensions
#. Click **ENABLE**:
.. figure:: /_static/images/services/lnbits/extensions-enable.png
:width: 40%
:alt: extensions-enable
#. Click **OPEN** *or* **LndHub** under *Extensions*:
.. figure:: /_static/images/services/lnbits/lndhub-open.png
:width: 40%
:alt: lndhub-open
#. Make sure the wallet you just created is selected below the two QR codes:
.. figure:: /_static/images/services/lnbits/lndhub-select-wallet.png
:width: 40%
:alt: lndhub-select-wallet
#. Install `Zeus <https://zeusln.app/>`_.
#. Open it up and click **SCAN NODE CONFIG**.
.. figure:: /_static/images/services/lnbits/scan-node-config.jpg
:width: 25%
:alt: scan-node-config
#. *If you only want this wallet to be able to RECEIVE PAYMENTS, scan this QR code:*
.. figure:: /_static/images/services/lnbits/left-qr.png
:width: 40%
:alt: left-qr
*If you are happy for this wallet to be able to both receive and MAKE payments scan this QR code:*
.. figure:: /_static/images/services/lnbits/right-qr.png
:width: 40%
:alt: right-qr
#. Once scanned, name the wallet if you wish, then hit **SAVE NODE CONFIG**.
.. figure:: /_static/images/services/lnbits/save-node-config.jpg
:width: 25%
:alt: save-node-config
#. Zeus will now connect to your node and you'll see this screen:
.. figure:: /_static/images/services/lnbits/new-wallet-screen-zeus.png
:width: 25%
:alt: new-wallet-screen-zeus
.. tip:: If it doesn't work, please manually restart the Zeus app.
#. You can now add sats to this wallet in two ways. You can allocate sats within LNbits by clicking the **+** icon here:
.. figure:: /_static/images/services/lnbits/plus-icon.png
:width: 60%
:alt: plus-icon
Let's add 1000 satoshis:
.. figure:: /_static/images/services/lnbits/add-1000-sats.png
:width: 60%
:alt: add-1000-sats
.. figure:: /_static/images/services/lnbits/1k-sats.png
:width: 60%
:alt: 1k-sats
Alternatively you can simply hit **Request** in Zeus and receive by generating a standard lightning invoice:
.. figure:: /_static/images/services/lnbits/zeus-request.png
:width: 20%
:alt: zeus-request
.. note:: This will only work if your node has inbound liquidity. And you cannot send sats from the LND node LNbits is using as that is not a regular lightning payment - that is a reblanace.
#. Once you have added sats, you can click on this button within Zeus and see your new balance:
.. figure:: /_static/images/services/lnbits/zeus-balance-button.png
:width: 20%
:alt: zeus-balance-button
.. figure:: /_static/images/services/lnbits/zeus-balance.png
:width: 20%
:alt: zeus-balance
Congratulations! Zeus 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.