Intro to Core Lightning Node

Core Lightning Node (officially created and maintained by Blockstream)

How do I set up Core Lightning?

Firstly, you can install Core Lightning from the app store on your Umbrel!

Then here’s a great tutorial via Blockstream’s Twitter:

Catch this quick demonstration on getting started with @Core_LN on @umbrel to learn:

🔒 How to send #Bitcoin to your node
🏞 Channel openings with peers
🍻 How to get inbound liquidity using @Boltzhq

Setting up a Core Lightning Node on Umbrel, Video by Blockstream on YouTube

— Blockstream (@Blockstream) June 30, 2023

Using Core Lightning and Accessing the Core Lightning command line

A Core Lightning node running c-lightning / Core Lightning is a separate Lightning Node implementation by Blockstream vs LND by Lightning Labs

Balances won’t reflect as it’s a different node, you can run them simultaneously on Umbrel

If you want to interact and access the Core Lightning command line, you run commands interacting with lightningd - basically what is running in your LIGHTNINGDIR for Core Lightning on Umbrel

Referencing steps on How to SSH

SSH into Umbrel and run this command first (you only have to do this once):

sudo /umbrel/scripts/app compose core-lightning exec lightningd lightning-cli -lightning-dir=/umbrel/app-data/core-lightning/data/lightningd

Then you can access the Core Lightning lightning-cli commands like this by prepending the following to all commands, and replacing with the command you’d like to run:

sudo ~/umbrel/scripts/app compose core-lightning exec lightningd lightning-cli <command>

Backing up a Core Lightning node

c-lightning/Core Lightning nodes don’t have a seed phrase exactly, they operate by interacting with a file called hsm_secret

You can see the process of backing up Core Lightning here: https://lightning.readthedocs.io/BACKUP.html

We recommend being confident in performing a recovery before storing any significant amount in any Lightning Node

This is a great guide!

I was trying to run the lightning-hsmtool command to generate a hsm_secret file using seed words of my own, and I can’t seem to make it work. The command processes for a moment, then just goes back to the directory. Any ideas?

I am following this guide, but they are on Linux, not umbrel: https://youtu.be/fvB1SmY-y98?si=2792DXMcZUiH4Qd4&t=673

This is the command I am running:

~/umbrel/scripts/app compose core-lightning exec lightningd lightning-hsmtool generatehsm hsm_secret

Second question: Permission is being denied when trying to sudo cd into ~/umbrel/app-data/core-lightning/data/lightningd/bitcoin. I can access using ‘sudo su,’ but is there a way to access that folder normally?

Thanks!

The Referencing steps on How to SSH link is 404.

it’s here good sir: Official Umbrel Troubleshooting Guide and FAQ

I just installed CL from the app store but I get a password prompt when I try to open it. I haven’t set up any password and I don’t see any default password on the app store page. What can I do? Thanks!

@BitByBit there shouldn’t be any traditional OAuth like with any other websites on the internet. If the application requires an admin login it’s set for you automatically on login for things like nextcloud and you can see default login credentials in the download page of the app store suite on your server once you one click installed for your personal homelab/server.
For Core Lightning Node check the backup steps above for its specific way to back up hsm secret specific to Core Lightning unlike other offchain nodes and unlike how an onchain wallet operates with a 12 word or 24 word mnemonic and + your lightning channel states, or be sure to have them backed up/or close channels and sweep all your money back into another wallet and you can reinstall the application or begin to get confident in that before making more changes with larger sums in max send or max receive for liquidity.
(Making sure if funds are in there make sure you’re backed up before any catastrophic issue occurs like a meteor strike, flooding, fire, etc. or you deposit like an excess amount of $ for channel liquidity I’d usually say 250,000 sats or roughly $150-$200 is a good amount for liquidity, historically only what you need on hand right now for the next hour or so of transactions like a coffee or a purchase of an item from a business)… To fund a node like that with no issue if you already backed up or sweeped funds back out, obviously. Indeed this makes it so you can host your own bank for your family and friends i.e. a minimal amount to $100, $150, $250+ so you only need enough liquidity on hand to handle max receive and sends back and forth for immediate purchases i.e. daily this in fact makes lightning sends good for small amounts, and thus the main strategic goal too L2 lightning is solving for offchain…

To start you just boot it up and begin the channel funding process to open channels with peers. I suggest be familiar with Core Lightning’s backup features before more usage or significant funds being deposited. Being comfortable with the hsm secret unique to Core Lightning nodes or a passphrase/password which a seed phrase generally is the password (not really but you all get it), to access or your recover your node.

Lightning Node App separate from LND will have a different balance as previously stated, all LND apps will show balances similary across your server like Ride the Lightning will show the same amounts as lightning node app since it’s all your LND on one node. Your Core Lightning Node app will show a different balance because it is running a different implementation formerly c-lightning, core lightning by Blockstream. Lightning Node App operates differently than the hsm secret, it has an aezeed seed phrase for offchain lightning and the backup proces is made easier on Umbrel so you can easily back up and recover your channels automatically, this is not a feature on core lightning maintained by Blockstream and thus I suggest being familiar with this process.

Let us know if there any issues here in the community and everyone should be welcome to participate here or ping Blockstream in their Core Lightning Discord, on 𝕏, or hop into Umbrel discord Support | Umbrel officially linked here, see ya in there!