Run litd

Run litd in integrated or remote mode.

We recommend running litd in integrated mode. This lets you run LND, Loop, Pool, Faraday and in the future, Taproot Assets, in a single binary. You can also run litd alongside your existing LND, Loop, Pool or installation. Generally, litd makes it easy for you to selectively switch between integrated and remote mode for each component, allowing you to selectively upgrade each component, apply patches, or run your own forks.

Integrated mode

Running litd in integrated mode allows the user to run everything in a single binary. To run litd in integrated mode, we will first need to configure our Bitcoin backend and LND.

Configure Bitcoin

If you have not run LND on this machine before, you will need to configure a Bitcoin backend. You may refer to the Configuration section in our Run LND guide. If you intend to run with a Neutrino backend, no action needs to be taken in this step.

Configure litd

To configure litd, we will first create the .lit directory and place a configuration file in it.

mkdir ~/.lit nano ~/.lit/lit.conf

We need to place the following information into this configuration file:

lnd-mode=integrated uipassword=<a random password of your choosing>

We will also need to configure LND here. If you have run LND before on this machine or have an existing configuration that you would like to use, you can copy it into the lit.conf file. Don’t forget to prefix every option with lnd., for instance: lnd.bitcoin.node=bitcoind lnd.bitcoind.rpchost= lnd.bitcoind.rpcuser=youruser lnd.bitcoind.rpcpass=yourpass lnd.bitcoind.zmqpubrawblock=tcp:// lnd.bitcoind.zmqpubrawtx=tcp://

Run litd

You can now run litd, LND, Loop, Pool and Faraday together by executing litd. You will have to unlock LND with lncli unlock, or create a new wallet if this is your first time starting LND.


Next: Connect to Terminal

Learn: Command Line Interface

Remote mode

Remote mode refers to a litd installation that runs separately from LND. By default, such an installation does not need configuration beyond passing a UI password.

Configure LND

To make use of litd's Accounts and Autofees features, you will need to enable the RPC Middleware interceptor. This can be done by adding the following line to your lnd.conf:


Run litd

We can start litd with the command:

litd --uipassword=<your secure and unique password>

If litd is unable to connect to LND, you might have to manually pass the location of the macaroon and RPC port or generate a litd configuration file, ~/.lit/lit.conf

lnd-mode=remote remote.lnd.rpcserver= remote.lnd.macaroonpath=/home/user/.lnd/data/chain/bitcoin/mainnet/admin.macaroon remote.lnd.tlscertpath=/home/user/.lnd/tls.cert

It is also possible to run litd in either integrated or remote mode and swap Loop, Pool or Faraday between remote and integrated mode.

For example:

lnd-mode=remote faraday-mode=integrated loop-mode=integrated pool-mode=remote

Next: Connect to Terminal

Learn: Command Line Interface

Regtest and Simnet

To run litd on regtest or simnet, the autopilot has to be disabled.


Access the litd user interface

Once litd is running, you should be able to navigate to localhost:8443 and access the user interface of litd.

To access the interface from a remote machine, don’t forget to launch litd with the flag --httpslisten= or add httpslisten= to your lit.conf file.

Last updated