2
0
mirror of https://github.com/Ride-The-Lightning/RTL synced 2024-11-15 18:13:00 +00:00
RTL/.github/docs/RTL_setups.md

60 lines
2.7 KiB
Markdown
Raw Normal View History

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
5. Make the following changes to the RTL-Config.json file
2019-03-22 20:52:03 +00:00
```
{
"multiPass": "<password in plain text, Default 'password'>",
"port": "3000",
"defaultNodeIndex": 1,
"dbDirectoryPath": "<Complete path of the folder where rtl's database file should be saved>",
"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>",
"swapMacaroonPath": "<Path of the folder containing 'loop.macaroon' on the device running RTL>",
"boltzMacaroonPath": "<Path of the folder containing 'admin.macaroon' on the device running RTL>",
"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",
"fiatConversion": false,
"unannouncedChannels": false,
"lnServerUrl": "<https://<ip-address-of-device-running-lnd>:8080; e.g. https://192.168.0.1:8080>",
"swapServerUrl": "<https://<localhost>:8081>",
"boltzServerUrl": "<https://<localhost>:9003>"
}
}
]
}
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)