You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
ShahanaFarooqui 04f909329e
Merge pull request #1137 from Ride-The-Lightning/Release-0.13.2
2 weeks ago
.circleci Docker compose update for multiarch 4 months ago
.github Unannounced Channel Configuration #1036 3 weeks ago
.vscode CLN Forwarding history filter and lint fixes 3 months ago
backend LND blank remote alias bug fix 2 weeks ago
docker Service Directory Structure Update 3 months ago
dockerfiles Dependency updates 4 months ago
frontend lnd AMP Invoice 2 weeks ago
server LND blank remote alias bug fix 2 weeks ago
src lnd AMP Invoice 2 weeks ago
.DS_Store sign components test fix 2 years ago
.browserslistrc Release 0.10.0 (#571) 2 years ago
.dockerignore Release 0.12.0 (#916) 11 months ago
.editorconfig Release 0.10.0 (#571) 2 years ago
.eslintrc.json LND & ECL Column Labels 1 month ago
.gitattributes Initial commit 4 years ago
.gitignore Documentation update for npm install error #1049 4 months ago
LICENSE Create LICENSE 4 years ago
Sample-RTL-Config.json Unannounced Channel Configuration #1036 3 weeks ago
angular.json Release 0.12.0 (#916) 11 months ago
package-lock.json More bug fixes 2 weeks ago
package.json Merge pull request #1070 from erikarvstedt/fix-dependencies 2 months ago
rtl.js Updated Server Message #1013 7 months ago
tsconfig.json Release 0.12.0 (#916) 11 months ago

.github/README.md

Ride The Lightning (RTL)

Known Vulnerabilities license

Intro -- Application Features -- Road Map -- Application Configurations -- Core Lightning -- Eclair -- Contribution

Introduction

RTL is a full function, device agnostic, web user interface to help manage lightning node operations. RTL is available on LND, CoreLightning and Eclair implementations.

  • Core Lightning users, refer to this page for install instructions.
  • Eclair users, refer to this page for install instructions.
  • LND users, follow the instructions below

Pre-requisite for running RTL is a functioning and synced LND node. If you are a Raspberry Pi or a Linux user, you can follow the famous Stadicus's guide to setup a Bitcoin + Lighting node.

RTL is available on the below platforms/services:

Docker Image: https://hub.docker.com/r/shahanafarooqui/rtl

Architecture

Prerequisites

  • Functioning and synced LND lightning node.
  • Node.js, which can be downloaded here
  • Recommended Browsers: Chrome, Firefox, MS Edge

Installation

To download a specific RTL version follow the instructions on the release page

To download from master (not recommended):

First time setup

$ git clone https://github.com/Ride-The-Lightning/RTL.git
$ cd RTL
$ npm install --omit=dev

Or: Update existing dependencies

$ cd RTL
$ git reset --hard HEAD
$ git clean -f -d
$ git pull
$ npm install --omit=dev

Prep for Execution

RTL requires its own config file RTL-Config.json, to start the server and provide user authentication on the app.

Advanced users can refer to this page, for config settings required to manage multiple nodes

  • Rename the file Sample-RTL-Config.json to RTL-Config.json located at./RTL.
  • Locate the complete path of the readable macroon file (admin.macroon) on your node and the lnd.conf file.
  • Modify the RTL-Config.json file per the example file below

Example RTL-Config.json:

{
  "multiPass": "password",
  "port": "3000",
  "defaultNodeIndex": 1,
  "SSO": {
    "rtlSSO": 0,
    "rtlCookiePath": "",
    "logoutRedirectLink": ""
  },
  "nodes": [
    {
      "index": 1,
      "lnNode": "LND Testnet",
      "lnImplementation": "LND",
      "Authentication": {
        "macaroonPath": "<Complete path of the folder containing LND's admin.macaroon for the node # 1>",
        "swapMacaroonPath": "<Complete path of the folder containing Loop's loop.macaroon for the node>",
        "boltzMacaroonPath": "<Complete path of the folder containing Boltz admin.macaroon for the node>",
        "configPath": "<Optional:Path of the .conf if present locally or empty>",
        "lnApiPassword": "<Optional:Can be used to provide password in ECL implementation>"
      },
      "Settings": {
        "userPersona": "OPERATOR",
        "themeMode": "DAY",
        "themeColor": "PURPLE",
        "channelBackupPath": "C:\\RTL\\backup\\node-1",
        "bitcoindConfigPath": "<Optional: path of bitcoind.conf path if available locally>",
        "logLevel": "INFO",
        "fiatConversion": false,
        "unannouncedChannels": false,
        "lnServerUrl": "<url for LND REST APIs for node #1 e.g. https://192.168.0.1:8080>",
        "swapServerUrl": "<url for swap server REST APIs for the node. e.g. https://localhost:8081>",
        "boltzServerUrl": "<url for boltz server REST APIs for the node. e.g. https://localhost:9003>"
      }
    }
  ]
}

For details on all the configuration options refer to this page.

User Authentication on RTL

RTL requires the user to be authenticated by the application first, before allowing access to LND functions. Specific password must be provided in RTL-Config.json (in plain text) for authentication. Password should be set with multiPass:<user defined> in the Authentication section of RTL-Config.json. Default initial password is password.

Start the Server

Run the following command:

$ node rtl

If the server started successfully, you should get the below output on the console:

$ Server is up and running, please open the UI at http://localhost:3000 or your proxy configured url.

Optional: Running RTL as a service (Rpi or Linux platform users)

In case you are running a headless Rpi or a Linux node, you can configure RTL as a service.

  • Create RTL systemd unit and with the following content. Save and exit.
# Raspibolt RTL: systemd unit for RTL
# /etc/systemd/system/RTL.service

[Unit]
Description=RTL daemon
Wants=lnd.service
After=lnd.service

[Service]
ExecStart=/usr/bin/node <Full path of the RTL folder>/rtl
User=<user>
Restart=always
TimeoutSec=120
RestartSec=30

[Install]
WantedBy=multi-user.target
  • enable and start RTL
$ sudo systemctl enable RTL
$ sudo systemctl start RTL
  • montior the RTL log file in realtime(exit with Ctrl-C)

$ sudo journalctl -f -u RTL

Accessing the Application

You can access the application in multiple setups (Please make note of the 4th exception):

  1. Same device as the server: Open your browser at the following address: http://localhost:3000 to access the RTL application.

  2. Remotely from another device on the same local network (home network) as the node(RTL server+LND running on the same device):

  • Ensure that the if a firewall running on your node, it allows access on port 3000 (or the custom port configured for RTL).
  • Determine the IP address of your node to access the application. E.g. if the IP address of your node is 192.168.0.15 then open your browser at the following address: http://192.168.0.15:3000 to access RTL.
  1. Config tweaks for running RTL server and LND on separate devices on the same network can be found here.

  2. Any Other setup: Please be advised, if you are accessing your node remotely via RTL, its critical to encrypt the communication via use of https. You can use solutions like nginx and letsencrypt or TOR to setup secure access for RTL.

  • Sample SSL setup guide can be found here
  • (For advanced users) A sample SSL guide to serve remote access over an encrypted Tor connection can be found here

Troubleshooting

In case you are running into issues with the application or if you have feedback, feel free to open issues on our github repo. You can also reach out to us via twitter DM on @Suheb__ or @RTL_App. Thanks for your interest.