2
0
mirror of https://github.com/Ride-The-Lightning/RTL synced 2024-10-31 09:20:27 +00:00
RTL/.github/docs/Eclair_setup.md
Shahana Farooqui 64173a8b2d Documentation update for npm install error #1049
Documentation update for npm install error #1049
2022-08-05 23:01:46 -07:00

3.6 KiB

RTL Eclair setup

Introduction

RTL is now enabled to manage an Eclair node.

Follow the below steps to install and setup RTL to run on Eclair.

Pre-requisites:

  1. Functioning Eclair node v0.4.1 or above. Follow install instructions on their github page.
  2. Bitcoin core v0.19.1 or above (this is an Eclair dependency).
  3. NodeJS - Can be downloaded here

Installation:

Eclair is integrated with RTL v0.8.0 and above. To download a specific RTL version follow the instructions on the release page

To download from master (not recommended) follow the below instructions:

First time setup

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

Or: Update existing build

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

Prep for Execution

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

  • Rename the file Sample-RTL-Config.json to RTL-Config.json located at./RTL..
  • Locate the complete path of the readable eclair.conf for your node.
  • Modify the RTL conf file per the example file below

Ensure that the follow values are correct per your config:

  • lnImplementation - This should be ECL, indicating that RTL is connecting to an Eclair node.
  • lnServerUrl - complete url with ip address and port of the eclair server.
  • multiPass - Specify the password (in plain text) to access RTL. This password will be hashed and not stored as plain text.
  • configPath (Optinal) - Full path of the folder containing eclair.conf including the file name. Can be used for the basic password authentication through eclair.api.password.
  • lnApiPassword (Mandatory if configPath is missing) - The same value from eclair.conf's eclair.api.password should be provided directly here. It will be used for Eclair API authentication.
{
  "multiPass": <password required for accessing RTL>,
  "port": "3000",
  "defaultNodeIndex": 1,
  "SSO": {
    "rtlSSO": 0,
    "rtlCookiePath": "",
    "logoutRedirectLink": ""
  },
  "nodes": [
    {
      "index": 1,
      "lnNode": "Eclair Testnet # 1",
      "lnImplementation": "ECL",
      "Authentication": {
        "configPath": "<Optional - Config file path, including .conf file>",
        "lnApiPassword": "<Mandatory if the configPath is missing - Password used for API authentication>",
      },
      "Settings": {
        "userPersona": "OPERATOR",
        "themeMode": "DAY",
        "themeColor": "PURPLE",
        "bitcoindConfigPath": "",
        "logLevel": "INFO",
        "fiatConversion": false,
        "lnServerUrl": "http://<eclair api server ip address>:port"
      }
    }
  ]
}

Start the server and access the app

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.

Open your browser at the following address: http://localhost:3000 to access the RTL app.

Detailed config and instructions

For detailed config and access options and other information, view the main readme page.