Add documentation for LND migration actions (#435)

* Add documentation for LND migration actions

* Update index.rst

* Update site/source/user-manual/upgrade-hardware/lnd-migration.rst

* Update site/source/user-manual/upgrade-hardware/index.rst

---------

Co-authored-by: kn0wmad <39687477+kn0wmad@users.noreply.github.com>
This commit is contained in:
Dominion5254
2023-07-13 16:57:57 -05:00
committed by GitHub
parent 32d5708046
commit 82b7341d5e
3 changed files with 36 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 353 KiB

View File

@@ -11,6 +11,15 @@ Guides for migrating or upgrading your server's hardware.
<div class="grid-x grid-margin-x">
.. topic-box::
:title: Migrate LND from other nodes to StartOS
:link: lnd-migration
:icon: scylla-icon scylla-icon--home
:class: large-5
:anchor: Upgrade
This is for migrating LND from another node to StartOS without closing channels
.. topic-box::
:title: Upgrade SSD
:link: drive-upgrade
@@ -55,6 +64,7 @@ Guides for migrating or upgrading your server's hardware.
:maxdepth: 2
:hidden:
LND migration <lnd-migration>
SSD upgrade <drive-upgrade>
Pro upgrade <upgrade-pro>
NASPi upgrade <naspi-upgrade>

View File

@@ -0,0 +1,26 @@
.. _lnd-migration:
========================
Migrating LND to StartOS
========================
.. warning:: **After migrating an LND wallet to StartOS, NEVER restart your old node. Turning on your old node can result in the broadcast of old channel states and potentially loss of funds!**
This guide is for users seeking to migrate LND on-chain and lightning funds from a different node to StartOS easily and without closing channels. This migration will require two sets of hardware, your existing hardware you wish to migrate from, and the hardware running StartOS you are migrating to. Both devices must be running on the same LAN. The LND service on StartOS provides easy to use actions for users migrating from the below Node implementations:
- Umbrel (Both 0.4 and 0.5)
- RaspiBlitz
- myNode
**Instructions**
#. First, you will first navigate to your LND service on StartOS and click the `Stop` button to stop LND.
.. warning:: Running any of the migration actions above will delete any existing LND wallet running on your StartOS server. If you have funds on your StartOS LND node, make sure to transfer these funds to another wallet before running a migration action.
#. Select the action corresponding to the node you are migrating from and fill out the corresponding IP and password(s). If you are unsure of the IP address of your node, you may need to check your router.
.. figure:: /_static/images/hardware-pics/lnd_migration_actions.png
:width: 60%
#. The migration action may take several minutes to complete. Once the action has completed and your old node has been unplugged, you may safely start LND on StartOS. **Remember - NEVER restart your old node after the migration has completed!**