BR⚡LN Guide
How to set up a Lightning node at home
A Lightning node is a computer that stays on all the time and holds your channels and your sats, without depending on any company. This guide shows the way with LightningOS, the free and open-source system maintained by BR⚡LN.
What you need
- A computer just for the node, on around the clock: an x86 (amd64) mini PC or a Raspberry Pi 5.
- An SSD. If you run a full Bitcoin Core at home, the blockchain takes hundreds of gigabytes: plan on 1 TB or more. With a remote Bitcoin node (see step 3), a smaller SSD is enough.
- A stable internet connection and, if you can, a UPS: a node that keeps going down loses channels and reputation.
- Some on-chain sats to open your first channels.
Step 1: the operating system
Install Ubuntu Server on the mini PC (or Debian 12 on the Raspberry Pi 5, which has its own guide in the repository). A clean install with nothing but SSH access is the ideal starting point.
Step 2: install LightningOS
On a clean Ubuntu, one command installs everything: Postgres, Tor, LND and the control panel.
curl -fsSL https://raw.githubusercontent.com/jvxis/brln-os-light/main/lo_bootstrap.sh | sudo ACCEPT_MIT_LICENSE=1 bash
When it finishes, the installer shows the panel address, which you open in a browser on another computer on the same network, on port 8443. If you already have a node running LND and Bitcoin, do not use this command: the repository has a separate installer for existing nodes.
Important: the LightningOS panel is for your local network. Never open port 8443 on your router to the internet; to reach it from outside, use a VPN such as Tailscale.
Step 3: the node's Bitcoin
Every Lightning node needs to talk to a Bitcoin node. There are two ways:
- Bitcoin Core at home: you validate everything yourself, but the first sync takes days.
- Remote Bitcoin: the LightningOS setup wizard accepts the credentials of a Bitcoin RPC. BR⚡LN Club members use the club's Bitcoin node and start the same day, without downloading the whole blockchain.
Step 4: the wallet and the seed
The wizard creates the LND wallet and shows the seed, a list of 24 words. Write it down on paper, keep it away from the computer, and never photograph it or save it to the cloud. Without the seed there is no way to recover the on-chain funds if the disk dies.
Step 5: the first channel
Send sats to the node's on-chain wallet and open one or two channels with stable, well-connected nodes. Very small channels earn little, and many large nodes only accept channels above a minimum size; the Lightning node explorer shows the channels and fees of any node before you choose.
Step 6: protect your channels
- Channel backup: LND keeps a
channel.backupfile that changes every time a channel opens or closes. Copy it off the node whenever it changes. - Watchtower: a watchtower steps in if someone tries to close one of your channels with an old state while your node is offline. The club runs one for its members.
Step 7: test the node from outside
Once the node is up, run the Lightning node checker: a 0 to 100 score covering reachability, channels, concentration and fees. Then use Is my Lightning node reachable? to confirm that other nodes can connect to yours over the internet and over Tor. To understand the connection options, read Reachable Lightning node: Tor, clearnet or both?
Frequently asked questions
How much does it cost to set up a Lightning node?
LightningOS is free. The cost is the computer and the SSD, plus the sats you put into channels. A used mini PC and an SSD are enough to start.
Do I need to keep the node on all the time?
Yes. A node that is offline does not forward payments, and peers end up closing channels with nodes that are always disconnected.
Can I use a Raspberry Pi?
Yes: LightningOS has an install for the Raspberry Pi 5 with Debian 12. Use an SSD, not a memory card.
Do I need to download the whole blockchain?
Only if you run Bitcoin Core at home. With a remote Bitcoin node, like the one the BR⚡LN Club offers its members, the node starts the same day.
