Manual configuration

Step 1:

SSH into your node.

Step 2:

Edit your lnd.conf and enter your node’s externally visible IP as an entry:

tlsextraip=[YOUR_NODE_IP]

or

tlsextradomain=[YOUR_NODE_DOMAIN]

(please note the tlsextraip= or tlsextradomain lines may appear multiple times).

Make sure it contains the following settings:

tlsautorefresh=1
rpclisten=0.0.0.0:10009
restlisten=0.0.0.0:8080

Step 3:

Shut down lnd.

Step 4:

mv .lnd/tls.cert .lnd/tls.cert.backup
mv .lnd/tls.key .lnd/tls.key.backup

Step 5:

Start lnd.

In Orb, now click on app > connection settings, and add the following information:

Node type and IP Address

Enter your node’s IP or domain name:

Protocol

Select the protocol. Desktop users can use both GRPC and REST, while mobile users can only connect via REST.

Port

The ports can most likely be left untouched, unless you have selected a different port for security reasons.

TLS Certificate

Orb requires you to copy your TLS certificate over from your node, and ingest it into Orb. Since we take security seriously, the certificate is encrypted using a unique RSA key.

Thus you’ll first need to install the python3 rsa module on your node:

pip3 install rsa

Next copy the command:

You can refer to Connection Strings if you are curious to know what the connection command does).

Paste it in your node’s terminal, and run it.

This should output multiple lines ending with two equal signs, ==. Copy those lines, and paste them into Orb:

If you carried out those steps successfully, the dialog should say ‘Certificate correctly formatted’.

Macaroon

The steps for the Macaroon are identical to those for the certificate.

Click close and restart Orb.