You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at 0.3.5.x.
Here we’ll show you how to install a lightning node and how to open a channel with Start9!
First, ensure that you have Bitcoin Core installed, running, and synced:
Install a lightning node. There are two options we offer on the Start9 marketplace - LND and Core Lightning. In this guide we’re going to use Core Lightning (CLN). Though you can use LND and the process will be almost exactly the same.
Install one of the above lightning implementations - as mentioned in this guide we’ll use CLN.
You’ll see CLN say Needs Config. Click Configure:
You can leave the settings as their default values and hit SAVE.
Now hit Start and wait for CLN to sync up to the network. This may take a few hours.
Once the Synced health check turns green (as below) you can proceed to the next step.
To interact with your node we will use Ride The Lightning (RTL) - this is a service that provides a graphical user interface for our lightning node.
This will work with either (or both!) lightning implementations.
Install it and click on Configure just like with CLN.
It will default to LND. In this case we are using a CLN node instead, so we will change the default setting as shown:
Change to Core Lightning (CLN) and hit OK:
Now hit Start:
With RTL started, click Properties:
Copy the automatically generated password:
Head back to the RTL service and click Launch UI:
Enter the copied password and log in:
You can add the password to your password manager for convenience.
Once in RTL, click On-chain then click Generate Address:
Send bitcoin to the generated address to add funds to your lightning wallet:
Please do not send money to the address pictured above as we will not receive it. If you are intent on sending us money please head here
Once your sats confirm on-chain you’ll see this:
Now we must add a peer with which to make channels. In this example we will be opening a channel with Start9 so we will add Start9’s node as a peer. Click Peers/Channels:
Click Peers then Add Peer:
Enter the details of the lightning node you’d like to open a channel with. Start9’s node can be found here and is what we’ll use in this example. You can use another node if you like - ideally one that is well connected. Once chosen and added as below, click Add Peer:
The syntax is as follows NodePublicKey@ipaddress:port - If it’s a Tor node it will be PublicKey.onion:port instead.
Then you can enter an amount (the size of the channel), select Private Channel (unless you want a public channel - see below), and a Fee Rate (check a block explorer for an idea of current necessary fees):
Here we are creating a very small channel with a capacity for payments of only a few dollars. You will likely want your channel to be larger than this so that it’s actually usable for reasonably sized payments. Channels this small may well get closed by the remote peer.
Using a private channel is what we advise as a default. You may wish for the channel to be public if you intend on becoming a routing node or for other reasons.
You will now see your channel in Channels -> Pending/Inactive:
Once the transaction opening the channel gets added to a block your channel will soon appear here under Open:
To make a payment head to the Transactions tab and press Send Payment:
That’s it! You now have a lightning node running with a channel open ready to send payments on the lightning network!
You will not be able to receive payments until you have inbound liquidity in your channel. After completing the above process you will only have outbound liquidity. Inbound liquidity can be created by making payments, having someone open a channel to you or via more sophisticated channel creation.
If you want to connect other applications or wallets to your node, please see the guides here.