Upgrading Umbrel Node

From PlebNet Wiki
Jump to navigation Jump to search
Other languages:


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.

File: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. For example, do note that all files under ~/umbrel area are overwritten. Some online tutorials mistakenly recommended installing certain tools under ~/umbrel/apps area and they will be gone.

If there is any custom code/application/things you want to save, keep them under ~/ or ~/mydir or ~/<yourname> area.

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. With umbrel 0.4.1 lnd.conf is not overwritten but better safe than sorry

    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

  7. Note down your running TMUX sessions, and bos telegram connect keys


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. With umbrel 0.4.1 lnd.conf is not overwritten so you can only find new parameters added after upgrade if any.
  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
  5. reconnect bos telegram, streaming htlc, and any other services you run under TMUX