-
Notifications
You must be signed in to change notification settings - Fork 72
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
GITBOOK-471: change request with no subject merged in GitBook
- Loading branch information
1 parent
9b6a2b9
commit 3769fc2
Showing
1 changed file
with
15 additions
and
23 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,39 +1,31 @@ | ||
--- | ||
description: Install and run Loop | ||
description: Install Loopd from source or the binaries | ||
--- | ||
|
||
# 🛠 Get Started | ||
# 🛠️ Get Started | ||
|
||
## Install Loop <a href="#docs-internal-guid-a15d1019-7fff-cd65-8961-f4145a3bd0d5" id="docs-internal-guid-a15d1019-7fff-cd65-8961-f4145a3bd0d5"></a> | ||
|
||
Loop comes bundled with [Lightning Terminal](../lightning-terminal/). Meaning, if you have Lightning Terminal installed, you can already access Loop through the command line and you may skip the step below. | ||
Loop comes bundled with [Lightning Terminal](../lightning-terminal/) (`litd`). If you are already running `litd`, you can access Loop through the command line or the [Lightning Terminal UI](../lightning-terminal/connect.md) and may skip the steps below. | ||
|
||
\[[Follow this guide to install Lightning Terminal](../lightning-terminal/get-lit.md)] | ||
[Follow this guide to install Lightning Terminal](../lightning-terminal/get-lit.md) | ||
|
||
To run Loop you need to be running LND from the [binary releases](https://github.com/lightningnetwork/lnd/releases), or compile from source with the command `make install tags="signrpc walletrpc chainrpc invoicesrpc"` | ||
## Installation | ||
|
||
You can run Loop directly from the binary releases, or compile it from source: | ||
To run Loop you need to be running LND from the[ binary releases](https://github.com/lightningnetwork/lnd/releases), or compile from source with the command make install `tags="signrpc walletrpc chainrpc invoicesrpc"` | ||
|
||
`git clone https://github.com/lightninglabs/loop.git`\ | ||
`cd loop`\ | ||
`make && make install` | ||
|
||
## Run Loop | ||
|
||
Loop, like bitcoind, LND and others, comes with two components: Loopd and a command line interface (CLI) to interact with it called loop. | ||
### Run the Binary <a href="#docs-internal-guid-42583cca-7fff-ed7e-46c6-2304f786c1e8" id="docs-internal-guid-42583cca-7fff-ed7e-46c6-2304f786c1e8"></a> | ||
|
||
You will need to first run Loop with the command `loopd` | ||
You can run Loop directly from the binary releases, [which you can find here](https://github.com/lightninglabs/loop/releases). | ||
|
||
If you want to run Loop in the background, you can also write the output to `/dev/null` by amending `&>/dev/null &` to the above command. | ||
### Compile from source | ||
|
||
### Lightning Terminal | ||
You can compile Loop from source. This requires Golang. Instructions for how to install Go can be found in the [LND installation guide](../lnd/run-lnd.md). | ||
|
||
If you are running Lightning Terminal already, either locally or remotely, Loop will be running inside of it already. You can make use of Loop using the Lightning Terminal GUI as explained in the Guide to Lightning Terminal. | ||
|
||
If you want to interact with Loop in Lightning Terminal through the command line, you will need to specify the port and tls.cert every time you run loop using the flag `--rpcserver=localhost:8443 --tlscertpath=~/.lit/tls.cert`, for example `./loop --rpcserver=localhost:8443 --tlscertpath=~/.lit/tls.certquote in 500000` | ||
|
||
Alternatively you may also copy over the `tls.cert` from `~/.lit` into `~/.loop/mainnet` | ||
`git clone https://github.com/lightninglabs/loop.git`\ | ||
`cd loop`\ | ||
`make && make install` | ||
|
||
If you are a Lightning Terminal user and want to avoid having to include the `--rpcserver` command every time or navigate to the location of the loop binary, you may also add an entry to your aliases file (e.g. `~/.bash_aliases`): | ||
## Configuration | ||
|
||
`alias loop=’~/path/to/loop --rpcserver=localhost:8443’` | ||
By default, the `loopd.conf` is placed in `~/.loop/mainnet/` If you are starting `loopd` on another network (e.g. `loopd --network=signet`), the configuration file is expected in the relevant directory (e.g. `~/.loop/signet`). You may also pass a custom directory with the `--configfile=` flag. |