2019-03-22 20:38:17 +00:00
### Documenting the different RTL setups and the corresponding config tweaks
2019-03-22 21:19:12 +00:00
#### RTL Server+LND running on the same device
2019-04-14 00:10:54 +00:00
For this type of setup, just follow the instructions on the [readme ](../README.md )
2019-03-22 20:38:17 +00:00
2019-03-22 21:19:12 +00:00
#### RTL Server and LND running on different devices (Local LAN)
2019-03-22 20:52:03 +00:00
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
2020-01-20 16:15:04 +00:00
5. Make the following changes to the RTL-Config.json file
2019-03-22 20:52:03 +00:00
```
2020-01-20 16:15:04 +00:00
{
"multiPass": "< password in plain text , Default ' password ' > ",
"port": "3000",
"defaultNodeIndex": 1,
2023-02-18 01:33:33 +00:00
"dbDirectoryPath": "< Complete path of the folder where rtl ' s database file should be saved > ",
2020-01-20 16:15:04 +00:00
"SSO": {
"rtlSSO": 0,
"rtlCookiePath": "",
"logoutRedirectLink": ""
},
"nodes": [
{
"index": 1,
"lnNode": "LND Testnet",
"lnImplementation": "LND",
"Authentication": {
"macaroonPath": "< Path of the folder containing ' admin . macaroon ' on the device running RTL > ",
2020-12-20 23:36:04 +00:00
"swapMacaroonPath": "< Path of the folder containing ' loop . macaroon ' on the device running RTL > ",
2021-02-21 19:02:31 +00:00
"boltzMacaroonPath": "< Path of the folder containing ' admin . macaroon ' on the device running RTL > ",
2020-01-20 16:15:04 +00:00
"configPath": "< Optional:Path of the lnd . conf if present locally or empty > "
},
"Settings": {
"userPersona": "OPERATOR",
"themeMode": "DAY",
"themeColor": "PURPLE",
"channelBackupPath": "< RTL Root path + \backup \node-1 > ",
"bitcoindConfigPath": "< Optional: path of bitcoind . conf path if available locally > ",
2021-08-28 21:03:18 +00:00
"logLevel": "INFO",
2020-01-20 16:15:04 +00:00
"fiatConversion": false,
2022-11-16 03:17:23 +00:00
"unannouncedChannels": false,
2020-08-18 14:34:40 +00:00
"lnServerUrl": "< https: / / < ip-address-of-device-running-lnd > :8080; e.g. https://192.168.0.1:8080>",
2020-12-20 23:36:04 +00:00
"swapServerUrl": "< https: / / < localhost > :8081>",
2021-02-21 19:02:31 +00:00
"boltzServerUrl": "< https: / / < localhost > :9003>"
2020-01-20 16:15:04 +00:00
}
}
]
}
2019-03-22 20:52:03 +00:00
```
6. Restart RTL
2019-03-22 21:19:12 +00:00
7. Access RTL by opening your browser at the following address: http://localhost:3000
2019-03-22 21:03:00 +00:00
#### RTL and LND running on different devices (with LND running on an external network or a cloud service)
2019-03-22 21:07:28 +00:00
2019-03-22 21:07:05 +00:00
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 ](https://nginx.org/en/download.html ) encrypted with your [letsencrypt ](https://letsencrypt.org ) certificate.
2019-03-22 21:07:28 +00:00
2019-04-14 00:10:54 +00:00
A sample SSL setup guide can be found [here ](RTL_SSL_setup.md )