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.
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.
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.
To configure litd, we will first create the .lit directory and place a configuration file in it.
We need to place the following information into this configuration file:
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:
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.
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.
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
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,
It is also possible to run litd in either integrated or remote mode and swap Loop, Pool or Faraday between remote and integrated mode.
Once litd is running, you should be able to navigate to
localhost:8443and access the user interface of litd.
To access the interface from a remote machine, don’t forget to launch litd with the flag