Builder's Guide
  • Welcome to the Builder's Guide to the LND Galaxy!
  • The Lightning Network
    • Overview
    • Payment Channels
      • Lifecycle of a Payment Channel
      • Watchtowers
      • Understanding Sweeping
      • Etymology
    • The Gossip Network
      • Identifying Good Peers on the Lightning Network
    • Pathfinding
      • Finding routes in the Lightning Network
      • Channel Fees
      • Multipath Payments (MPP)
    • Lightning Network Invoices
      • Understanding Lightning Invoices
    • Making Payments
      • The Payment Cycle
      • Timelocks
      • ⭐Hashed Timelock Contract (HTLC)
      • Payment Etymology
      • ⭐What Makes a Good Routing Node
      • Understanding Submarine Swaps
      • Instant Submarine Swaps
    • Liquidity
      • ⭐Understanding Liquidity
      • Managing Liquidity on the Lightning Network
      • Liquidity Management for Lightning Merchants
      • How to Get Inbound Capacity on the Lightning Network
      • Lightning Service Provider
    • L402: Lightning HTTP 402 Protocol
      • Macaroons
      • L402
      • 📋Protocol Specification
      • Implementations and Links
    • Taproot Assets
      • Taproot Assets Protocol
      • Taproot Assets on Lightning
      • Edge Nodes
      • Taproot Assets Trustless Swap
      • FAQ
      • Glossary
  • Lightning Network Tools
    • LND
      • 🛠️Get Started
      • lnd.conf
      • First Steps With LND
      • Wallet Management
      • Sending Payments
      • Atomic Multi-path Payments (AMP)
      • Receiving Payments
      • Unconfirmed Bitcoin Transactions
      • Channel Fees
      • Inbound Channel Fees
      • Macaroons
      • Configuring Watchtowers
      • Pathfinding
      • Blinded Paths
      • Key Import
      • Secure Your Lightning Network Node
      • Configuration of a Routing Node
      • Quick Tor Setup
      • Configuring Tor
      • Enable ‘Neutrino mode’ in Bitcoin Core
      • Send Messages With Keysend
      • Partially Signed Bitcoin Transactions
      • Bulk onchain actions with PSBTs
      • Sweeper
      • Debugging LND
      • Fuzzing LND
      • LND API documentation
      • Channel Acceptor
      • RPC Middleware Interceptor
      • HTLC Interceptor
      • NAT Traversal
      • Recovery: Planning for Failure
      • Migrating LND
      • Disaster recovery
      • Contribute to LND
    • Lightning Terminal
      • What is Lightning Terminal?
      • 🛠️Get litd
      • Run litd
      • Integrating litd
      • Demo: Litd Speed Run
      • Connect to Terminal
      • Recommended Channels
      • Rankings
      • Health Checks
      • Liquidity Report
      • Opening Lightning Network Channels
      • Managing Channel Liquidity
      • Autofees
      • AutoOpen
      • LND Accounts
      • Loop and Lightning Terminal
      • Loop Fees
      • Pool and Lightning Terminal
      • Command Line Interface
      • Troubleshooting
      • Lightning Node Connect: Under the hood
      • LNC Node Package
      • LITD API Documentation
      • Privacy and Security
      • Privacy Policy
      • Terms of Use
    • Loop
      • 🛠️Get Started
      • The Loop CLI
      • Autoloop
      • Static Loop In Addresses
      • Instant Loop Outs
      • Peer with Loop
      • Loop API Documentation
    • Pool
      • Overview
      • Quickstart
      • 🛠️Installation
      • First Steps
      • Accounts
      • Orders and Asks
      • Sidecar Channels
      • Zero-confirmation Channels
      • Channel Leases
      • Batch Execution
      • Account Recovery
      • Pool API Documentation
      • FAQs
    • Taproot Assets
      • Get Started
      • First Steps
      • Taproot Assets Channels
      • Asset Decimal Display
      • Become an Edge Node
      • RFQ
      • Collectibles
      • Universes
      • Asset Loop
      • Debugging Tapd
      • Multisignature
      • Minting Assets With an External Signer
      • Lightning Polar
      • Operational Safety Guidelines
      • Taproot Assets API Documentation
    • Aperture
      • ⚒️Get Aperture
      • LNC Backend
      • LNC Mailbox
      • Pricing
    • Faraday
      • 🛠️Get Started
      • The Faraday CLI
      • Faraday API Documentation
  • LAPPs
    • Guides
      • Use Polar to Build Your First LAPP
        • Setup: Local Cluster with Polar
        • Setup: Run the Completed App
        • Setup: Run the App Without LND
      • Add Features
        • Feature 1: Connect to LND
        • Feature 2: Display Node Alias and Balance
        • Feature 3: Sign and Verify Posts
        • Feature 4: Modify Upvote Action
      • Make Your own LNC-powered Application
    • Next Steps
  • Community Resources
    • Resource List
    • Lightning Bulb 💡
    • Glossary
    • FAQ
Powered by GitBook
On this page
  • Integrated mode
  • Configure Bitcoin
  • Configure litd
  • Run litd
  • Remote mode
  • Configure LND
  • Run litd
  • Regtest and Signet
  • Access the litd user interface

Was this helpful?

  1. Lightning Network Tools
  2. Lightning Terminal

Run litd

Run litd in integrated or remote mode.

PreviousGet litdNextIntegrating litd

Last updated 1 day ago

Was this helpful?

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 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.active=1 lnd.bitcoin.node=bitcoind lnd.bitcoind.rpchost=127.0.0.1 lnd.bitcoind.rpcuser=youruser lnd.bitcoind.rpcpass=yourpass lnd.bitcoind.zmqpubrawblock=tcp://127.0.0.1:28332 lnd.bitcoind.zmqpubrawtx=tcp://127.0.0.1:28333

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.

litd

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

rpcmiddleware.enable=true

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=127.0.0.1:10009 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

Regtest and Signet

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

autopilot.disable=true

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=0.0.0.0:8443 or add httpslisten=0.0.0.0:8443 to your lit.conf file.

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

Next: Connect to Terminal
Learn: Command Line Interface
Accounts
Autofees
RPC Middleware interceptor
Next: Connect to Terminal
Learn: Command Line Interface
Configuration section in our Run LND guide.
Video: RUN LITD: Building a Node from Scratch