Upgrading Umbrel Node

From PlebNet Wiki
Revision as of 10:27, 13 August 2021 by VS (talk | contribs) (list numbering)
Jump to navigation Jump to search

Intro

Every once in a while you may have to upgrade your node. When a new upgrade is available, your umbrel dashboard will show a message like this.

Umbrell upgrade.jpg

However, before you rush in, it is better to be prepared for the upgrade so that you can recover from any surprises.

Upgrade Check List

The following checklist can help you prepare for any unforeseen circumstances before you upgrade.

  1. Take a Static Channel Backup
  2. Copy the output of bos peers or your channel listings from amboss so that you have a list of channels you have opened and local balances.
  3. Double check your 24-word seed for umbrel and any wallet passwords you have setup. Keep a safe backup.
  4. Make an upgrade area to safe keep some files. ssh to your node and

    cd ~
    mkdir upgrade
    cd upgrade

  5. copy lnd.conf. Upgrade will overwrite it and you will need to re-do your customization again.

    cp ~/umbrel/lnd/lnd.conf ~/upgrade/

  6. take a list of your watchtower peers so that you can add them again (if they are lost)

    ~/umbrel/bin/lncli wtclient towers | tee ~/upgrade/wtclienttowers.json

updrade

Follow the instructions to upgrade

post upgrade

  1. make a general healthchecks of your channels, nodes, balances.
  2. compare the lnd.conf in upgrade directory with ~/umbrel/lnd/lnd.conf and repeat your customisation again. If only changes are your own changes, you can also replace the file with the one you saved before the upgrade.
  3. restart lnd cd ~/umbrel ; docker-compose restart lnd; docker-compose ps
  4. compare your watch towers are still intact or else add them again. ~/umbrel/bin/lncli wtclient towers