lnd
starsforks
How to install lnd?
lightninglabs/lightning-agent-tools/lnd
$npx -y skills add lightninglabs/lightning-agent-tools --skill lndInstall and run Lightning Terminal (litd) which bundles lnd, loop, pool, tapd, and faraday in a single Docker container. Defaults to neutrino backend with SQLite storage on testnet. Supports watch-only mode with remote signer, standalone mode, and regtest development. Use when se
SKILL.md
| 1 | # Lightning Terminal (litd) — Lightning Network Node |
| 2 | |
| 3 | Install and operate a Lightning Terminal (litd) node for agent-driven payments. |
| 4 | litd bundles lnd with loop, pool, tapd, and faraday — giving agents access to |
| 5 | liquidity management, channel marketplace, and taproot assets in a single |
| 6 | container. |
| 7 | |
| 8 | **Default:** Docker container, neutrino backend, SQLite storage, testnet. No full |
| 9 | Bitcoin node required. Use `--network mainnet` for real coins. |
| 10 | |
| 11 | **Default mode: watch-only with remote signer.** Private keys stay on a separate |
| 12 | signer container — the agent never touches key material. For quick testing, use |
| 13 | `--mode standalone` (keys on disk, less secure). |
| 14 | |
| 15 | ## Quick Start (Container — Recommended) |
| 16 | |
| 17 | ### Watch-Only with Remote Signer (Production) |
| 18 | |
| 19 | ```bash |
| 20 | # 1. Install litd image |
| 21 | skills/lnd/scripts/install.sh |
| 22 | |
| 23 | # 2. Start litd + signer containers |
| 24 | skills/lnd/scripts/start-lnd.sh --watchonly |
| 25 | |
| 26 | # 3. Set up signer wallet (first run only) |
| 27 | skills/lightning-security-module/scripts/setup-signer.sh --container litd-signer |
| 28 | |
| 29 | # 4. Import credentials and create watch-only wallet |
| 30 | skills/lnd/scripts/import-credentials.sh --bundle ~/.lnget/signer/credentials-bundle |
| 31 | skills/lnd/scripts/create-wallet.sh |
| 32 | |
| 33 | # 5. Check status |
| 34 | skills/lnd/scripts/lncli.sh getinfo |
| 35 | ``` |
| 36 | |
| 37 | ### Standalone (Testing Only) |
| 38 | |
| 39 | ```bash |
| 40 | # 1. Install litd image |
| 41 | skills/lnd/scripts/install.sh |
| 42 | |
| 43 | # 2. Start litd container |
| 44 | skills/lnd/scripts/start-lnd.sh |
| 45 | |
| 46 | # 3. Create standalone wallet (generates seed — keys on disk) |
| 47 | skills/lnd/scripts/create-wallet.sh --mode standalone |
| 48 | |
| 49 | # 4. Check status |
| 50 | skills/lnd/scripts/lncli.sh getinfo |
| 51 | ``` |
| 52 | |
| 53 | > **Warning:** Standalone mode stores the seed mnemonic and wallet passphrase on |
| 54 | > disk. Do not use for mainnet funds you cannot afford to lose. |
| 55 | |
| 56 | ### Regtest Development |
| 57 | |
| 58 | ```bash |
| 59 | # Start litd + bitcoind for local development |
| 60 | skills/lnd/scripts/start-lnd.sh --regtest |
| 61 | |
| 62 | # Create wallet and mine some blocks |
| 63 | skills/lnd/scripts/create-wallet.sh --container litd --mode standalone |
| 64 | docker exec litd-bitcoind bitcoin-cli -regtest -generate 101 |
| 65 | ``` |
| 66 | |
| 67 | ## Container Modes |
| 68 | |
| 69 | | Mode | Command | Containers | Use Case | |
| 70 | |------|---------|-----------|----------| |
| 71 | | Standalone | `start-lnd.sh` | litd | Testing, development | |
| 72 | | Watch-only | `start-lnd.sh --watchonly` | litd + litd-signer | Production | |
| 73 | | Regtest | `start-lnd.sh --regtest` | litd + litd-bitcoind | Local dev | |
| 74 | |
| 75 | ## Profiles |
| 76 | |
| 77 | Profiles customize litd behavior without editing compose files: |
| 78 | |
| 79 | ```bash |
| 80 | # List available profiles |
| 81 | skills/lnd/scripts/docker-start.sh --list-profiles |
| 82 | |
| 83 | # Start with a profile |
| 84 | skills/lnd/scripts/start-lnd.sh --profile taproot |
| 85 | skills/lnd/scripts/start-lnd.sh --profile debug |
| 86 | ``` |
| 87 | |
| 88 | | Profile | Purpose | |
| 89 | |---------|---------| |
| 90 | | `default` | Standard operation (info logging) | |
| 91 | | `debug` | Trace logging, verbose subsystems | |
| 92 | | `taproot` | Simple taproot channels enabled | |
| 93 | | `wumbo` | Large channels up to 10 BTC | |
| 94 | | `regtest` | Regtest network preset | |
| 95 | |
| 96 | ## Network Selection |
| 97 | |
| 98 | Default is testnet. Override with `--network`: |
| 99 | |
| 100 | ```bash |
| 101 | # Testnet (default — no real coins) |
| 102 | skills/lnd/scripts/start-lnd.sh |
| 103 | |
| 104 | # Mainnet (real coins — use with remote signer) |
| 105 | skills/lnd/scripts/start-lnd.sh --network mainnet --watchonly |
| 106 | |
| 107 | # Signet (testing network) |
| 108 | skills/lnd/scripts/start-lnd.sh --network signet |
| 109 | ``` |
| 110 | |
| 111 | ## litd Sub-Daemons |
| 112 | |
| 113 | litd integrates multiple daemons. Access them via the `--cli` flag: |
| 114 | |
| 115 | ```bash |
| 116 | # lnd CLI (default) |
| 117 | skills/lnd/scripts/lncli.sh getinfo |
| 118 | |
| 119 | # Loop — liquidity management (submarine swaps) |
| 120 | skills/lnd/scripts/lncli.sh --cli loop quote out 100000 |
| 121 | |
| 122 | # Pool — channel marketplace |
| 123 | skills/lnd/scripts/lncli.sh --cli pool accounts list |
| 124 | |
| 125 | # Taproot Assets (tapd) |
| 126 | skills/lnd/scripts/lncli.sh --cli tapcli assets list |
| 127 | |
| 128 | # Lightning Terminal (litd) |
| 129 | skills/lnd/scripts/lncli.sh --cli litcli getinfo |
| 130 | |
| 131 | # Faraday — channel analytics |
| 132 | skills/lnd/scripts/lncli.sh --cli frcli revenue |
| 133 | ``` |
| 134 | |
| 135 | ## Installation |
| 136 | |
| 137 | Default: pulls the litd Docker image. |
| 138 | |
| 139 | ```bash |
| 140 | skills/lnd/scripts/install.sh |
| 141 | ``` |
| 142 | |
| 143 | This pulls `lightninglabs/lightning-terminal:v0.16.0-alpha` from Docker Hub and |
| 144 | verifies the image. The litd image includes lncli, litcli, loop, pool, tapcli, |
| 145 | and frcli. |
| 146 | |
| 147 | ### Build from Source (Fallback) |
| 148 | |
| 149 | ```bash |
| 150 | skills/lnd/scripts/install.sh --source |
| 151 | ``` |
| 152 | |
| 153 | Requires Go toolchain. Builds lnd and lncli with all build tags. |
| 154 | |
| 155 | ## Native Mode |
| 156 | |
| 157 | For running without Docker, use `--native`: |
| 158 | |
| 159 | ```bash |
| 160 | # Start natively |
| 161 | skills/lnd/scripts/start-lnd.sh --native --mode standalone |
| 162 | |
| 163 | # Stop natively |
| 164 | skills/lnd/scripts/stop-lnd.sh --native |
| 165 | ``` |
| 166 | |
| 167 | Native mode uses the config template at `skills/lnd/templates/ln |
People who liked this also viewed
6 picksType
- remotion-to-hyperframesPort an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing RemotioSkillsJul 2026
- solana-devUse when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "deploy to devnet", or "explain SSkillsJul 2026
- grimoire-polymarketQueries Polymarket market data and CLOB state, and manages CLOB orders via the Grimoire venue CLI wrapper backed by the official Polymarket CLI.SkillsMay 2026
- shopify-storefront-graphqlUse for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI. NOT foSkillsJul 2026
- agentic-walletCrypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API callSkillsJun 2026
- quicknode-skillQuicknode blockchain infrastructure for 80+ chains: Core RPC API, Streams, Webhooks, Blazar WSS, Solana gRPC, HyperCore gRPC, SQL Explorer, Metaplex DAS API, Blockbook, Ordinals & Runes API, Swap API,SkillsJul 2026
