Icon of Core Lightning app on Umbrel App Store

Core Lightning

Run your personal Core Lightning node

Core Lightning

Open App Store on your umbrelOS device to install this app
Screenshot 1 of Core Lightning app on Umbrel App Store
Screenshot 2 of Core Lightning app on Umbrel App Store
Screenshot 3 of Core Lightning app on Umbrel App Store
About this app

Get started with the Lightning network today with Core Lightning - a Lightning Network implementation focusing on spec compliance and performance.

The Lightning Network allows ultra cheap and almost instant Bitcoin transactions. By running a Lightning node, you can not only self-custody your Bitcoin on Lightning, but also earn sats by routing payments on the network.

Core Lightning and Application powered by Blockstream.

What's new
Version 25.09.3-hotfix.1last week

This hotfix release fixes an issue where users were unable to connect external wallet clients to their Core Lightning node. If you were previously unable to connect a wallet, please go to "Settings" in the top right > Connect wallet > and select your desired connection method to see corrected connection details.

Previous release notes:

This updates cln-application to v25.07.3, lightningd to v25.09.3, and replaces the legacy c-lightning-rest service with the built-in REST interface of lightningd.

CLN Application v25.07.3:

  • Proactive mitigation against a widespread npm ecosystem threat involving malicious code in popular packages.
  • Updated and streamlined environment variables for improved configuration and usability
  • Added support for running Commando over secure WebSocket (eg. wss-proxy) connections
  • Removed version and commit suffix from node aliases for a cleaner display
  • Updated BKPR date format from YYYY-MM-DD to UI standard DD MMM, YYYY
  • Added infinite scroll support for BTC Transactions, CLN Offers, and CLN Transactions

CLN v25.09.3:

  • Bookkeeper has been migrated into core lightning, allowing visibility into payments, fees and channel activities.
  • xpay can now directly pay BIP353 addresses (like ₿cln@blockstream.com) and simple offers without extra steps.
  • Better feedback when channel creation fails due to capacity limits.
  • Now limiting the number of parts a payment can be split on xpay and askrene
  • Reckless now supports the modern uv package manager for Python plugins.
  • Improvements to the rate of feasible solutions found in the main loop of the solver on askrene
  • Splicing improvements allow for better compatibility with Eclair and continuous routing during channel modifications.
  • Improve security by ensuring all peers must support channel type.
  • Payment secrets now mandatory in BOLT11 invoices for better payment protection.
Version 25.09.3last week

This updates cln-application to v25.07.3, lightningd to v25.09.3, and replaces the legacy c-lightning-rest service with the built-in REST interface of lightningd.

CLN Application v25.07.3:

  • Proactive mitigation against a widespread npm ecosystem threat involving malicious code in popular packages.
  • Updated and streamlined environment variables for improved configuration and usability
  • Added support for running Commando over secure WebSocket (eg. wss-proxy) connections
  • Removed version and commit suffix from node aliases for a cleaner display
  • Updated BKPR date format from YYYY-MM-DD to UI standard DD MMM, YYYY
  • Added infinite scroll support for BTC Transactions, CLN Offers, and CLN Transactions

CLN v25.09.3:

  • Bookkeeper has been migrated into core lightning, allowing visibility into payments, fees and channel activities.
  • xpay can now directly pay BIP353 addresses (like ₿cln@blockstream.com) and simple offers without extra steps.
  • Better feedback when channel creation fails due to capacity limits.
  • Now limiting the number of parts a payment can be split on xpay and askrene
  • Reckless now supports the modern uv package manager for Python plugins.
  • Improvements to the rate of feasible solutions found in the main loop of the solver on askrene
  • Splicing improvements allow for better compatibility with Eclair and continuous routing during channel modifications.
  • Improve security by ensuring all peers must support channel type.
  • Payment secrets now mandatory in BOLT11 invoices for better payment protection.
Version 25.05-patch.1last month

This update adds support for Backups in umbrelOS 1.5.

Previous release notes for v25.05:

This release of Core Lightning includes many improvements, bug fixes, and new features.

CLN Application v0.0.7:

  • Adding long awaited Bookkeeper graphs for account events, sats flow and volume
  • New SQL Terminal to run SQL queries directly from the UI
  • Connect wallet modal shows clnrest and cln-grpc information

CLN Rest v0.10.7:

  • added support for generating p2tr addresses

CLN v25.05:

  • Reduced latency of commit and revoke messages.
  • Reckless can update existing reckless-installed plugins via reckless update.
  • Fixed routing of AskRene via high capacity channels.
  • More accurate anchor fees.
  • Channel backup turns our peers into watchtowers by now allowing your node to generate penalty transactions!
  • blacklisted runes can now be restored via relist.
  • xpay has many, many bugfixes, and is now almost seamlessly compatible when xpay-handle-pay is used.
  • lightning-cli has neater help output, and doesn't crash occasionally on xpay notifications.
  • setconfig does more safety checks and uses a separate "config.setconfig" file for runtime changes: you can also now set transient=true if you don't want the config files changed.
  • Fixed a bug where we would fail to collect our own funds if we force closed a channel we had leased with --experimental-dual-fund.
Version 25.054 months ago

This release of Core Lightning includes many improvements, bug fixes, and new features.

CLN Application v0.0.7:

  • Adding long awaited Bookkeeper graphs for account events, sats flow and volume
  • New SQL Terminal to run SQL queries directly from the UI
  • Connect wallet modal shows clnrest and cln-grpc information

CLN Rest v0.10.7:

  • added support for generating p2tr addresses

CLN v25.05:

  • Reduced latency of commit and revoke messages.
  • Reckless can update existing reckless-installed plugins via reckless update.
  • Fixed routing of AskRene via high capacity channels.
  • More accurate anchor fees.
  • Channel backup turns our peers into watchtowers by now allowing your node to generate penalty transactions!
  • blacklisted runes can now be restored via relist.
  • xpay has many, many bugfixes, and is now almost seamlessly compatible when xpay-handle-pay is used.
  • lightning-cli has neater help output, and doesn't crash occasionally on xpay notifications.
  • setconfig does more safety checks and uses a separate "config.setconfig" file for runtime changes: you can also now set transient=true if you don't want the config files changed.
  • Fixed a bug where we would fail to collect our own funds if we force closed a channel we had leased with --experimental-dual-fund.
Version 24.11.1-grpc8 months ago

This update makes the gRPC interface in Core Lightning accessible for companion apps you install.

For example, as a result of this change, the newest Ride The Lightning release integrates Boltz as a service, allowing you to seamlessly swap in and out of the Lightning Network.

Version 24.11.19 months ago

This updates cln-application to v0.0.6, and lightningd to v24.11.1. cln-application v0.0.6:

  • Bug fix: Change uppercase invoices and offers to lowercase.

  • Enhancement: Create and Display Invoice Rune on Connect Wallet.

  • Deprecation: Resolve commando-rune deprecation and use createrune instead.

lightningd v24.11.1:

  • xpay is a new, experimental plugin for payments. It's rewritten from the ground up, on top of another plugin called askrene, which provides advanced routing advice for payments. The two play together: xpay tells askrene about the results of payment attempts, so it learns over time. The hard work was done by @Lagrang3 who wrote and refined the minimum-cost-flow solver which is the heart of askrene.

  • Paying and receiving offers (bolt12 send and receive) are enabled by default! This reflects it finally being included in the BOLT specs in September, to applause from all the different Lightning implementers.

  • listpays now takes start and limit parameters to speed it up if you only want recent payments.

  • CLN is smarter about remembering where the node successfully connected out to a peer, and will always try that again.

  • The autoclean plugin would make nodes freeze for 30 seconds at a time when had a lot of work to do: it is now kinder and gentler.

  • Faster gossip which is helpful for everyone stay up-to-date with what is happening in the network.

  • Connectd will connect faster on startup, maintaining up to 10 outgoing connection attempts in parallel.

  • Some nasty bugs fixed, including one where extended downtime could mean we might never fully resolve unilateral closes (just missing returning the funds to our wallet).

Full lightningd release notes are available at https://github.com/ElementsProject/lightning/releases

Version 24.05last year

This updates lightningd to v24.05. If you are running the Ride The Lightning app, please update it to the latest version in the Umbrel App Store after updating Core Lightning to maintain compatibility.

lightningd v24.05:

  • New rune restrictions can now be applied to invoices with the pinv restriction.
  • Stability fixes to gossip and anchor channel spends.
  • Increased file descriptor limits for large nodes.
  • Pruned node operation is better supported by bcli with more robust block fetching.
  • Pay can now pay part of an invoice with the partial_msat parameter. Get someone else to pay the remainder.
  • Check can now be used to validate setconfig settings and values. It can also check for approval by the hsmd of keysend payments.
  • Offers will now make an outgoing connection if necessary to reply to an invoice request.

Full lightningd release notes are available at https://github.com/ElementsProject/lightning/releases

Version 24.02.2last year

This updates cln-application to v0.0.5, and lightningd to v24.02.2.

cln-application:

  • bug fix for opening channel
  • fixed message on the empty transactions channel card
  • bug fix for RC version compatibility check
  • added gRPC options on connect wallet
  • listpeers no longer returns channel, updated the endpoint to listpeerchannels

Full cln-application release notes are available at https://github.com/ElementsProject/cln-application/releases/tag/v0.0.4

c-lightning-REST v0.10.5:

  • plugin.js renamed to clrest.js (required for reckless plugin manager)
  • allow an option to specify an IP address to bind with the server
  • bug fix for error on generating new certificates
  • bug fix for websocket notifications
  • setchannelfee rpc has been replaced by setchannel (no impact to the developers as REST API signature remains unchanged)
  • fixed the issue of server failing to initialize if IPV6 is disabled
  • pay api updated with the latest params
  • the msat purge
  • new API endpoint for listpeerchannels rpc
  • issue in the remote balance calculation fixed
  • issue in the pending balance calculation fixed
  • version compatibility check to address BTCPayserver forked version
  • all available filtering options (invoice, payment hash & offer) for listInvoices api
  • all CLN filtering options (payment hash & status) for listPays and listPayments apis

Full c-lightning-REST release notes are available at https://github.com/Ride-The-Lightning/c-lightning-REST/releases

lightningd v24.02.2:

  • pay route algorithm doesn't bias against our own "expensive" channels any more
  • pay route algorithm fixed and refined to balance fees and capacity far better
  • prevents repeating the preapproveinvoice check
  • gossip feature bit deprecation for LDK compatibility fix
  • renepay bugfix with situation htlcmax=htlcmin
  • recover plugin can now detect dataloss and guide you through the recovery process, making emergency recoveries less stressful
  • logic of the anchor channels has been overhauled and channel fundings and closing should now be more flexible and reliable
  • dual-funding has been merged into the Lightning Specification! This is a major milestone for more efficient channel management
  • gossip_store file can now be shared with others, since it no longer contains local unpublished gossip
  • optimizations in the way we process blocks means that we can sync with the blockchain 50% faster than before
  • new --no-reconnect-private flag, which tells lightningd not to reconnect private peers. This is useful for service-providers and LSPs if the majority of peers is flaky
  • newest version of the splicing proposal was implemented

Full lightningd release notes are available at https://github.com/ElementsProject/lightning/releases

Version 23.08-hotfix-12 years ago

This hotfix update resolves an issue that was preventing the Core Lightning app from operating on test networks such as testnet. No additional changes are included in this release.

The release notes from 23.08 are included here for completeness.

cln-application v0.0.4 (user interface):

  • bug fix by filtering lnmessage's pubkey from peers list
  • added support for more fiat currencies

Full cln-application release notes are available at https://github.com/ElementsProject/cln-application/releases/tag/v0.0.4

c-lightning-REST v0.10.5:

  • plugin.js renamed to clrest.js (required for reckless plugin manager)
  • allow an option to specify an IP address to bind with the server
  • bug fix for error on generating new certificates
  • bug fix for websocket notifications
  • setchannelfee rpc has been replaced by setchannel (no impact to the developers as REST API signature remains unchanged)
  • fixed the issue of server failing to initialize if IPV6 is disabled
  • pay api updated with the latest params
  • the msat purge
  • new API endpoint for listpeerchannels rpc
  • issue in the remote balance calculation fixed
  • issue in the pending balance calculation fixed
  • version compatibility check to address BTCPayserver forked version
  • all available filtering options (invoice, payment hash & offer) for listInvoices api
  • all CLN filtering options (payment hash & status) for listPays and listPayments apis

Full c-lightning-REST release notes are available at https://github.com/Ride-The-Lightning/c-lightning-REST/releases

lightningd v23.08:

  • NEW experimental feature: peer storage - back up your encrypted emergency channel backup with your peers
  • access a remote node with a cli flag: lightning-cli --commando=peerid:rune
  • migrate all wrapped segwit UTXOs to native segwit with upgradewallet RPC.
  • large nodes are more performant.
  • pay requiring a full description (not just a hash) has been pushed back, since it broke BTCPayServer and lnbits. It's still deprecated, and we will work with them to try to achieve this.
  • documentation now available for Offers invoicerequest, disableinvoicerequest and listinvoicerequest commands.
  • NEW commando-blacklist and commando-listrunes RPCs for blacklisting and listing stored runes.
  • NEW feerates added 2 new options as "minimum" and NN"blocks". Use explicit block counts or slow/normal/urgent/minimum.
  • listclosedchannels RPC to show old, dead channels.
  • reckless added support for node.js plugin installation and for networks beyond bitcoin and regtest.
  • spending unilateral close transactions now use dynamic fees based on deadlines (and RBF), instead of fixed fees.

Full lightningd release notes are available at https://github.com/ElementsProject/lightning/releases

Version 23.082 years ago

This release updates the user interface, as well as the underlying c-lightning-REST and lightningd components of the Core Lightning app.

cln-application v0.0.4 (user interface):

  • bug fix by filtering lnmessage's pubkey from peers list
  • added support for more fiat currencies

Full cln-application release notes are available at https://github.com/ElementsProject/cln-application/releases/tag/v0.0.4

c-lightning-REST v0.10.5:

  • plugin.js renamed to clrest.js (required for reckless plugin manager)
  • allow an option to specify an IP address to bind with the server
  • bug fix for error on generating new certificates
  • bug fix for websocket notifications
  • setchannelfee rpc has been replaced by setchannel (no impact to the developers as REST API signature remains unchanged)
  • fixed the issue of server failing to initialize if IPV6 is disabled
  • pay api updated with the latest params
  • the msat purge
  • new API endpoint for listpeerchannels rpc
  • issue in the remote balance calculation fixed
  • issue in the pending balance calculation fixed
  • version compatibility check to address BTCPayserver forked version
  • all available filtering options (invoice, payment hash & offer) for listInvoices api
  • all CLN filtering options (payment hash & status) for listPays and listPayments apis

Full c-lightning-REST release notes are available at https://github.com/Ride-The-Lightning/c-lightning-REST/releases

lightningd v23.08:

  • NEW experimental feature: peer storage - back up your encrypted emergency channel backup with your peers
  • access a remote node with a cli flag: lightning-cli --commando=peerid:rune
  • migrate all wrapped segwit UTXOs to native segwit with upgradewallet RPC.
  • large nodes are more performant.
  • pay requiring a full description (not just a hash) has been pushed back, since it broke BTCPayServer and lnbits. It's still deprecated, and we will work with them to try to achieve this.
  • documentation now available for Offers invoicerequest, disableinvoicerequest and listinvoicerequest commands.
  • NEW commando-blacklist and commando-listrunes RPCs for blacklisting and listing stored runes.
  • NEW feerates added 2 new options as "minimum" and NN"blocks". Use explicit block counts or slow/normal/urgent/minimum.
  • listclosedchannels RPC to show old, dead channels.
  • reckless added support for node.js plugin installation and for networks beyond bitcoin and regtest.
  • spending unilateral close transactions now use dynamic fees based on deadlines (and RBF), instead of fixed fees.

Full lightningd release notes are available at https://github.com/ElementsProject/lightning/releases

Version 22.11.1-ui0.0.32 years ago

This update brings a stunning new look and intuitive UI, maintained officially by Blockstream

It includes two bug fixes:

  • Invalid rune error thrown on some slower machines.
  • Undefined msat fields shown as NaN will be 0.

This version also includes some enhanced features such as:

  • Updates for CLN v23.05 msat migration
  • Add Offers list view
  • Add Tor option for lnmessage on connect wallet

Full release notes are available at: https://github.com/ElementsProject/lightning/releases/tag/v22.11.1

Version 22.11.1-ui2 years ago
  • This update brings a stunning new look and intuitive UI, maintained officially by Blockstream
  • Core Lightning node control with Commando RPC calls, lnmessage, websocket-port & runes
  • Database upgrade support with database-update flag
  • Offers and fetchinvoice plugins enabled through experimental-offers
  • Application Features:
    • Smooth withdrawals and deposits
    • Simple opening and closing of channels
    • Effortless sending and receiving of invoices
    • Convenient management of offers (bolt12)
    • Seamless keysend functionality
    • And much more...

Click here for full changelog: https://github.com/ElementsProject/lightning/releases/tag/v22.11.1

Version 22.11.12 years ago
  • We reintroduced a number of deprecated features, since some integrations had missed the deprecation window, and asked for some more time to update their apps
  • The new experimental reckless plugin manager can be used to download, install and uninstall plugins on the fly. We have many new features planned for it, so stay tuned.
  • When receiving a keysend any extra TLV fields will be stored so they can be retrieved later.
  • The --database-update=false flag allows users wanting to test unreleased versions from accidentally upgrading the database, and then be unable to switch to a released version again.
  • Several performance issues, particularly for larger nodes, have been addressed

And much more. Full changelog from v0.11.1 can be found here: https://github.com/ElementsProject/lightning/releases

Version 0.11.1-build-53 years ago
  • Support for testnet, signet and regtest
Version 0.11.1-build-43 years ago
  • Update RESTful API to add support for Liquidity Ads
Version 0.11.1-build-33 years ago
Version 0.11.1-build-23 years ago
Information