No description
Find a file
Carl Dong 5c6fce304e docs: Match and pass /litrpc.* locations in nginx
Also escape the "." for more precise regex matching
2022-01-04 19:58:29 -05:00
.github multi: add litrpc package 2021-11-24 13:44:25 -05:00
.vscode chore: fix vscode linting with wrong TS version 2021-01-27 11:11:24 -05:00
app ui+nav: fix Lightning Node Connect link with custom path 2021-12-23 10:54:14 -05:00
cmd app+litcli: fix mailbox URL 2021-11-24 20:48:38 +01:00
doc docs: Match and pass /litrpc.* locations in nginx 2022-01-04 19:58:29 -05:00
litrpc session: add session package 2021-11-24 13:44:25 -05:00
make make: use latest git tag for version in release 2020-11-02 13:18:17 +01:00
proto app+proto: update protos to new lnd+pool versions 2021-11-25 10:27:52 +01:00
session session: fix uint64 overflow for dates in far future 2021-11-24 13:44:27 -05:00
.dockerignore cmd: rename binary to litd 2020-07-21 22:10:33 +02:00
.gitattributes chore: fix generated code being included in language stats 2020-12-11 18:00:16 -05:00
.gitignore cmd/litcli: add litcli for session functions 2021-11-24 13:44:26 -05:00
.prettierrc docs: reformat readme markdown 2020-06-13 00:39:59 -04:00
config.go cmd/litcli: add litcli for session functions 2021-11-24 13:44:26 -05:00
dev.Dockerfile cmd/litcli: add litcli for session functions 2021-11-24 13:44:26 -05:00
Dockerfile cmd/litcli: add litcli for session functions 2021-11-24 13:44:26 -05:00
go.mod mod: bump lnd to v0.14.1-beta 2021-11-24 23:12:40 +01:00
go.sum mod: bump lnd to v0.14.1-beta 2021-11-24 23:12:40 +01:00
gzip.go multi: rename golang and make files to lightning-terminal 2020-07-21 22:06:15 +02:00
LICENSE docs: add MIT license 2021-07-16 18:27:27 -04:00
log.go multi: implement LiT gRPC server 2021-11-24 13:44:25 -05:00
Makefile cmd/litcli: add litcli for session functions 2021-11-24 13:44:26 -05:00
README.md README: add version entry for patch 2021-12-03 22:59:56 +01:00
release.sh cmd/litcli: add litcli for session functions 2021-11-24 13:44:26 -05:00
rpc_proxy.go rpc_proxy+terminal: fix error handling with stateless init 2021-12-03 22:56:37 +01:00
session_rpcserver.go multi: implement LiT gRPC server 2021-11-24 13:44:25 -05:00
subserver_permissions.go multi: implement LiT gRPC server 2021-11-24 13:44:25 -05:00
terminal.go rpc_proxy+terminal: fix error handling with stateless init 2021-12-03 22:56:37 +01:00
tools.go mod+tools: add dummy import for CLI dependencies 2021-05-06 20:17:07 +02:00

Lightning Terminal (LiT)

CI

Lightning Terminal (LiT) is a browser-based interface for managing channel liquidity.

screenshot

Features

  • Visualize your channels and balances
  • Perform submarine swaps via the Lightning Loop service
  • Classify channels according to your node's operating mode
  • Run a single binary that integrates loopd, poold and faraday daemons all in one
  • Access a preview release of the Pool UI
  • Use Pool to earn sats by opening channels to those needing inbound liquidity

Installation

Download the latest binaries from the releases page.

Additionally, you can find detailed instructions on the docs.lightning.engineering page.

Execution

Run Lightning Terminal with a local lnd instance:

⛰  ./litd --uipassword=UP48lm4Vjqxy<change_this_or_you_will_get_robbed>

Visit https://localhost:8443 to access Terminal.

Note that a password with a minimum of 8 characters is required to run Lightning Terminal. In a production environment, it's recommended that you store this password as an environment variable to avoid it being recorded in the command history.

To use LiT with a remote lnd instance please follow these instructions. If you would like to replace your existing LND instance with the one integrated within LiT please see configuring Terminal.

LND

Note that LiT requires lnd to be built with all of its subservers and requires running at least v0.11.0. Download the latest official release binary or build lnd from source by following the installation instructions. If you choose to build lnd from source, use the following command to enable all the relevant subservers:

⛰  make install tags="signrpc walletrpc chainrpc invoicesrpc"

Interaction

If you plan to run LiT on a remote machine but access the web-interface from your computer you may not want to deal with self-signed certificate browser warnings. To avoid these warnings configure the HTTP server to use a certificate from Let's Encrypt. View the Let's Encrypt Configuration doc for instructions on how to configure this.

Upgrading

If you used command line arguments with previous versions then you don't need to change anything when upgrading.

To upgrade from v0.1.1-alpha or earlier simply create a lit.conf file in your LiT directory. The default location LiT uses depends on your operating system:

  • MacOS: ~/Library/Application Support/Lit/lit.conf
  • Linux: ~/.lit/lit.conf
  • Windows: ~/AppData/Roaming/Lit/lit.conf

Move all the configuration settings specific to LiT from lnd.conf to lit.conf and remove any previous LiT-specific customizations from the configuration settings in lnd.conf. Note that any section headers ([ Example ]) in lit.conf should be removed or changed to comments (# Example).

Usage

Read the walkthrough document to learn more about how to use LiT.

Troubleshooting

If you encounter any issues please see our troubleshooting guide.

Build from source

If youd prefer to compile from source code please follow these instructions.

Compatibility

Lightning Terminal is backwards compatible with lnd back to version v0.13.3-beta.

LiT LND
v0.6.1-alpha v0.13.3-beta
v0.6.0-alpha v0.13.3-beta
v0.5.2-alpha v0.12.0-beta
v0.5.1-alpha v0.12.0-beta
v0.5.0-alpha v0.12.0-beta
v0.4.1-alpha v0.11.1-beta
v0.4.0-alpha v0.11.1-beta
v0.3.4-alpha v0.11.1-beta
v0.3.3-alpha v0.11.1-beta
v0.3.2-alpha v0.11.1-beta
v0.3.1-alpha v0.11.1-beta
v0.3.0-alpha v0.11.1-beta
v0.2.0-alpha v0.11.0-beta

Daemon Versions packaged with LiT

LiT LND Loop Faraday Pool
v0.6.1-alpha v0.14.1-beta v0.15.1-beta v0.2.7-alpha v0.5.2-alpha
v0.5.3-alpha v0.13.3-beta v0.14.1-beta v0.2.6-alpha v0.5.0-alpha
v0.5.2-alpha v0.13.3-beta v0.14.1-beta v0.2.6-alpha v0.5.0-alpha
v0.5.1-alpha v0.13.0-beta v0.14.1-beta v0.2.6-alpha v0.5.0-alpha
v0.5.0-alpha v0.13.0-beta v0.14.1-beta v0.2.6-alpha v0.5.0-alpha
v0.4.1-alpha v0.12.1-beta v0.11.4-beta v0.2.3-alpha v0.4.4-alpha
v0.4.0-alpha v0.12.0-beta v0.11.2-beta v0.2.3-alpha v0.4.3-alpha
v0.3.4-alpha v0.11.1-beta v0.11.2-beta v0.2.2-alpha v0.3.4-alpha
v0.3.3-alpha v0.11.1-beta v0.11.2-beta v0.2.2-alpha v0.3.4-alpha
v0.3.2-alpha v0.11.1-beta v0.11.1-beta v0.2.2-alpha v0.3.4-alpha
v0.3.1-alpha v0.11.1-beta v0.11.1-beta v0.2.2-alpha v0.3.3-alpha
v0.3.0-alpha v0.11.1-beta v0.11.0-beta v0.2.2-alpha v0.3.2-alpha
v0.2.0-alpha v0.11.1-beta v0.10.0-beta v0.2.1-alpha n/a
v0.1.1-alpha v0.11.0-beta v0.8.1-beta v0.2.0-alpha n/a
v0.1.0-alpha v0.10.3-beta v0.6.5-beta v0.2.0-alpha n/a