Core Lightning
- Name: Core Lightning
- URL: https://docs.corelightning.org/docs/installation
- Category: Bitcoin Lightning node implementation / plugin-extensible node-operations stack / Lightning JSON-RPC infrastructure
- Tags: bitcoin-ecosystem
- Summary: Core Lightning is a Lightning node-and-ops substrate, not a wallet app and not just a reference binary. The useful split is the lean core plus the plugin surface around it: Unix-socket JSON-RPC, extensibility, reproducible builds, and deployment paths that let operators or packaged stacks shape the rest.
- What it does:
- Runs a Lightning Network node on top of a synchronized local or remote
bitcoindinstance and supports both mainnet and test environments such as testnet and regtest - Exposes a JSON-RPC 2.0 interface over a Unix domain socket, with
lightning-cliand a Python client library for programmatic control - Supports core node operations including address generation, fund tracking, peer connections, channel funding, invoice creation, payment sending, and plugin management
- Supports plugin-based extensibility and maintains a broader plugin ecosystem for adding operational and application-layer capabilities
- Offers multiple deployment paths including precompiled binaries, Docker images, source builds, nixOS packaging, and third-party GUI/operator environments such as Ride the Lightning, Umbrel, BTCPay Server, RaspiBlitz, and Start9
- Documents HD-wallet-seed encryption, reproducible builds, and optional Rust-based plugins such as
cln-grpc,clnrest,cln-bip353, andwss-proxy
- Runs a Lightning Network node on top of a synchronized local or remote
- Key claims:
- The official README describes Core Lightning as a lightweight, highly customizable, specification-compliant implementation of the Lightning Network protocol
- The README says the implementation has been in production use on Bitcoin mainnet since early 2018 and is considered stable enough for mainnet, even though new users are encouraged to start on testnet or regtest
- The README says Core Lightning works on Linux and macOS and requires a fully synchronized
bitcoindinstance at version 25.0 or above with transaction relay enabled - The README says Core Lightning exposes JSON-RPC 2.0 over a Unix domain socket and highlights operational RPC methods such as
newaddr,listfunds,connect,fundchannel,invoice,pay, andplugin - The README says Core Lightning does not require ZeroMQ or
txindexfor synchronization, which is a meaningful architectural distinction versus some other Bitcoin-node-adjacent tooling - The installation docs show supported distribution through GitHub release binaries, Docker images, and source compilation, plus GUI/operator integrations through Ride the Lightning, Umbrel, BTCPay Server, Raspiblitz, and Start9
- The installation docs show Core Lightning’s build and extension surface now includes optional Rust-backed components like
cln-grpc,clnrest,cln-bip353, andwss-proxy, while still allowing operators to disable Rust if those plugins are unnecessary
- Whitepaper: No canonical standalone Core Lightning whitepaper or litepaper surfaced in this pass. The clearest current sources of truth were the official README and installation docs; see
../whitepapers/core-lightning-primary-sources-2026-05-01.md. - Sources:
Internal linkages
- Company boundary for the broader implementation / service / wallet shell around this codebase: blockstream.
- Canonical implementation contrasts: lnd and eclair
Protocol / company boundary
- Keep this note on the implementation surface: the daemon, JSON-RPC model, plugin ecosystem, build and packaging choices, and the ways operators can compose Core Lightning into larger merchant, wallet, or node stacks.
- Use blockstream when the sharper question is who still stewards and packages this implementation inside a broader company shell that also includes Greenlight, wallet products, enterprise workflow, and commercial support paths.
- That split matters because
what capabilities and composition points does Core Lightning expose?andwhich company sits closest to the release, support, and commercialization shell around it?are related but not identical questions.
Control surface
-
Practical leverage sits in plugin choice, JSON-RPC exposure,
bitcoindcoupling, wallet-seed and build-verification discipline, and which surrounding packages turn the daemon into a friendlier merchant or node stack. -
Core Lightning matters because it keeps more of that composition visible instead of burying it in one blessed product shell.
-
The company note matters separately because Blockstream still packages and markets this implementation inside Greenlight and a broader company product surface without reducing Core Lightning itself to a mere vendor feature.
-
Read it as a modular Lightning backend, not as a complete operator experience on its own.
-
Last reviewed: 2026-08-06 UTC