Menu

Caution

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.

Opening Your First Channel

Here we’ll show you how to install a lightning node and how to open a channel with Start9!

Running a Node and Making a Channel with Start9

  1. First, ensure that you have Bitcoin Core installed, running, and synced:

    bitcoin-synced
  2. 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.

    two-impls-marketplace
  3. Install one of the above lightning implementations - as mentioned in this guide we’ll use CLN.

    cln-installing
  4. You’ll see CLN say Needs Config. Click Configure:

    cln-needs-config
  5. You can leave the settings as their default values and hit SAVE.

    cln-save-config
  6. Now hit Start and wait for CLN to sync up to the network. This may take a few hours.

    cln-syncing
  7. Once the Synced health check turns green (as below) you can proceed to the next step.

    cln-green
  8. 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.

    rtl-marketplace
  9. Install it and click on Configure just like with CLN.

    rtl-needs-config
  10. It will default to LND. In this case we are using a CLN node instead, so we will change the default setting as shown:

    rtl-config-lnd

    Change to Core Lightning (CLN) and hit OK:

    rtl-change-to-cln

    Hit Save:

    rtl-config-save
  11. Now hit Start:

    rtl-start
  12. With RTL started, click Properties:

    rtl-click-properties
  13. Copy the automatically generated password:

    rtl-copy-pass
  14. Head back to the RTL service and click Launch UI:

    rtl-launch-ui

    Enter the copied password and log in:

    rtl-enter-pass

    Note

    You can add the password to your password manager for convenience.

  15. Once in RTL, click On-chain then click Generate Address:

    rtl-generate-address
  16. Send bitcoin to the generated address to add funds to your lightning wallet:

    rtl-address-generated

    Note

    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

  17. Once your sats confirm on-chain you’ll see this:

    rtl-on-chain
  18. 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:

    rtl-peers-channels
  19. Click Peers then Add Peer:

    rtl-peers-add-peer
  20. 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:

    rtl-start9-node-info

    Note

    The syntax is as follows NodePublicKey@ipaddress:port - If it’s a Tor node it will be PublicKey.onion:port instead.

  21. 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):

    rtl-open-channel

    Note

    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.

    Note

    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.

  22. You will now see your channel in Channels -> Pending/Inactive:

    rtl-pending-inactive
  23. Once the transaction opening the channel gets added to a block your channel will soon appear here under Open:

    rtl-open-channels
  24. To make a payment head to the Transactions tab and press Send Payment:

    rtl-transactions-tab
  25. That’s it! You now have a lightning node running with a channel open ready to send payments on the lightning network!

Note

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.