RTL/RTL_setups.md

Documenting the different RTL setups and the corresponding config tweaks

RTL Server+LND running on the same device

For this type of setup, just follow the instructions on the readme

RTL Server and LND running on different devices (Local LAN)

If your running RTL and LND on different devices on your local LAN, certain config changes need to be made in LND and RTL conf files.

1. A static IP address must be assigned to the device running LND
2. admin.macaroon file must be transferred to the device on which you need to run RTL
3. Add to your lnd.conf file under the [Application Options] section: restlisten=<ip address of the device running LND>:8080
4. Restart LND
5. Make the following changes to the RTL.conf file

[Authentication]
macaroonPath=<Path of the folder containing 'admin.macaroon' on the device running RTL>
nodeAuthType=CUSTOM
rtlPass=<password in plain text>
[Settings]
lndServerUrl=https://<ip-address-of-device-running-lnd>:8080/v1

6. Restart RTL
7. Access RTL by opening your browser at the following address: http://localhost:3000

RTL and LND running on different devices (with LND running on an external network or a cloud service)

RTL is not recommended for this type of setup

In case you need to run RTL with an external node, you need to ensure that RTL is served on https, by running it behind a webserver like nginx encrypted with your letsencrypt certificate.

We have not provided a standardized guide for this setup. A documentation PR is welcome for this.