Skip to content

Commit

Permalink
watchtower: remove local watchtower
Browse files Browse the repository at this point in the history
  • Loading branch information
ecdsa committed Mar 28, 2021
1 parent ea422be commit 8b1eb54
Showing 1 changed file with 15 additions and 44 deletions.
59 changes: 15 additions & 44 deletions watchtower.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,51 +4,14 @@ How to setup a watchtower
This tutorial will show you how to configure your Electrum daemon as a
watchtower for your lightning wallet. It is written for Electrum 4.0.


Local and remote watchtower
---------------------------

There are two ways a watchtower can be configured in Electrum: Local
or Remote.

A local watchtower runs in the same process as your Electrum client,
and can be activated in the preferences dialog of the Qt GUI. A local
watchtower creates a database of pre-signed breach remedy
transactions, and it watches the funding addresses of your
channels. When your lightning wallet is open, breach remedy
transactions will be signed and added to the watchtower database.
Once you your wallet is closed, assuming Electrum is still running,
the local watchtower will watch your channels, and it will broadcast
pre-signed breach remedy transactions if needed.

A remote watchtower is a separate Electrum process, that runs on
another computer. To setup a remote watchtower, you need to configure
A watchtower is a separate Electrum process, that runs on
another computer. To setup a watchtower, you need to configure
an Electrum daemon, and to enter its URL in your preferences.


How to configure a local watchtower
------------------------------------

In your preferences, check 'Run a local watchtower'

.. image:: png/watchtower_settings.png


The second option ensures that Electrum keeps running on your computer
after you have closed your wallet file. If you click it, the Electrum
icon should persist in your taskbar after you have closed all your
Electrum windows.


If you have open channels and a local watchtower, Electrum will
populate the watchtower database. You can view the database size and
number of transactions per channel if you open the watchtower window:

.. image:: png/watchtower_window.png


How to configure a remote watchtower
------------------------------------
How to configure a watchtower
-----------------------------

You want to run your watchtower on a machine that is regularly
connected to the internet.
Expand All @@ -68,7 +31,7 @@ Second, configure your watchtower with an address, username and password:

.. code-block:: bash
electrum setconfig -o run_local_watchtower true
electrum setconfig -o run_watchtower true
electrum setconfig -o watchtower_user myusername
electrum setconfig -o watchtower_password mypassword
electrum setconfig -o watchtower_address example.com:12345
Expand All @@ -81,13 +44,21 @@ Then start the daemon:
The watchtower database contains presigned transactions, and is in
~/.electrum/watchtower_db If you open the GUI you can see hown many
channels and transactions are in the database.
~/.electrum/watchtower_db


Note that the daemon does not need to contain a wallet, nor to have
Lightning enabled; the watchtower is only about watching onchain
addresses and broadcasting onchain transactions.


If you run Electrum's Qt GUI on the machine that is configured as a
watchtower, you can view the database size and number of transactions
per channel if you open the watchtower window:

.. image:: png/watchtower_window.png


Configure the watchtower in your client
---------------------------------------

Expand Down

0 comments on commit 8b1eb54

Please sign in to comment.