Skip to content
Ride The Lightning build repository
Branch: master
Clone or download
ShahanaFarooqui coop channel filter fix and green theme color change
coop channel filter fix and green theme color change
Latest commit 0b6b5f2 Mar 24, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci circleci Feb 20, 2019
.github/ISSUE_TEMPLATE
angular coop channel filter fix and green theme color change Mar 24, 2019
controllers coop channel filter fix and green theme color change Mar 24, 2019
e2e Merging Angular pre-build code Mar 19, 2019
product management
routes Updated the secret key logic Feb 24, 2019
screenshots Add files via upload Feb 18, 2019
settings
src coop channel filter fix and green theme color change Mar 24, 2019
.DS_Store
.editorconfig
.gitattributes Initial commit Sep 15, 2018
.gitignore updating gitignore Mar 19, 2019
Application_configurations Update Application_configurations Feb 22, 2019
Application_features.md Update Application_features.md Feb 17, 2019
Dockerfile Have better docker caching (#63) Feb 25, 2019
Dockerfile.arm32v7 Have better docker caching (#63) Feb 25, 2019
LICENSE
LNDAPICoverage.md
README.md
RTL_setups.md Update RTL_setups.md Mar 22, 2019
Roadmap.md
_config.yml Set theme jekyll-theme-hacker Jan 11, 2019
angular.json
app.js Optimized initialization and optional params on send fund Mar 2, 2019
common.js Optimized initialization and optional params on send fund Mar 2, 2019
connect.js
package-lock.json
package.json
prebuild.js
protractor.conf.js
rtl.js Typo: missing "common." prefix for one "port" ref (#86) Mar 18, 2019
sample-RTL.conf
tsconfig.json Merging Angular pre-build code Mar 19, 2019
tslint.json Merging Angular pre-build code Mar 19, 2019

README.md

Ride The Lightning (RTL)

Known Vulnerabilities license

Stable Release: v0.2.15

Intro -- Application Features -- Road Map -- LND API Coverage -- Application Configurations

Introduction

RTL is a full function, device agnostic web user interface for Lightning Network Daemon, to help manage lightning node operations. Lightning Network Daemon is an implementation of Lightning Network BOLT protocol by Lightning Labs.

Pre-requisite for running RTL is a functioning and synced LND node. You can setup your own node, by following the below guides:

  • Windows/Mac users can follow Pierre Rochard's Node Launcher
  • Linux or Raspberry Pi users can follow Stadicus's guide

RTL source code is available at this repo

For detailed screenshots and UI operation guide you can visit our medium post

RTL is already available on:

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

First time setup

  • Fetch sources from the RTL git repository, by executing the below on the command prompt:

$ git clone https://github.com/ShahanaFarooqui/RTL.git

  • Change directory to RTL folder:

$ cd RTL

  • Fetch the dependencies and build the application by running:

$ npm install

Or: Update existing build

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

Prep for Execution

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

  • Rename sample-RTL.conf file to RTL.conf.
  • Locate the complete path of the readable macroon file (admin.macroon) on your node and the lnd.conf file.
  • Modify the RTL.conf file per the example file below

Example RTL.conf:

[Authentication]
macaroonPath=C:\Users\<user>\AppData\Local\Lnd\data\chain\bitcoin\testnet
nodeAuthType=CUSTOM
lndConfigPath=C:\Users\<user>\AppData\Local\Lnd\lnd.conf
rtlPass=***

[SSO]
rtlSSO=0
rtlCookiePath=C:\RTL\cookies\auth.cookie
logoutRedirectLink=/login

[Settings]
flgSidenavOpened=true
flgSidenavPinned=true
menu=Vertical
menuType=Regular
theme=dark-blue
satsToBTC=false
lndServerUrl=https://192.168.0.0:8080/v1
bitcoindConfigPath=
enableLogging=false
port=3000

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. There are two options to configure authentication on RTL, depending on the nodeAuthtype value provided in RTL.conf.

  • Option 1: nodeAuthType=DEFAULT; Password provided in lnd.conf for the rpc setting for bitcoind will be used for authentication.
  • Option 2: nodeAuthType=CUSTOM; Specific password must be provided in RTL.conf (in plain text) for authentication. Password should be set with rtlPass=<user defined> in the [Authentication] section of RTL.conf

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

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 seperate 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 to setup https access for RTL.

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 @Sauby_k or @RTL_App. Thanks for your interest.

You can’t perform that action at this time.