Running LNDHub on Mac OSX

How to deploy and run a LNDHub instance on Mac OSX and connect to BlueWallet.

JP Thor
4 min readFeb 16, 2019

Requirements:

Let’s create a self-sovereign mobile lightning wallet using nothing but a Mac, a mobile phone and some software supplied by the fantastic open source community!

Step 1 — LND

1A — Download and set up Pierre Rochard’s NodeLauncher.

Setup guide here:

Launch Bitcoin and LND

1B— “Launch Bitcoin” to begin syncing with Bitcoin (12–72 hours).

1C — “Launch LND” to start syncing LND (2–6 hours)

1D — “Create” LND Wallet

Step 2— LndHub

LndHub is the open-source wrapper for LND provided by BlueWallet.

2A — Set up the LNDHub

git clone git@github.com:BlueWallet/LndHub.git
cd LndHub

2B— Copy in the LND Macaroon admin.macaroonto the LndHub directory. Quick find from NodeLauncher, “Show Macroons”:

Click “Show Macaroons”

2C — Copy in the tls.cert file. Quick find by Nodelauncher “Advanced” menu, then “Show lnd.conf

Click “Show lnd.conf”
Copy this file into LndHub folder

2D — Edit the LndHub config.js file to add bitcoin RPC credentials

sudo nano config.js
  • Change bitcoind.rpc login:password to match the rpcuser & rpcpassword in your bitcoin.conf (use Nodelauncher Advanced menu to locate this file, and then a text editor to open)
  • Change all the IP addresses from 1.1.1.1 to 127.0.0.1
  • Change <LND gRPC Port> to what is specified on your NodeLauncher pane (usually 10010 )
  • Change the redis port from 12914 to 6379
let config = {bitcoind: {rpc: 'http://<rpcuser>:<rpcpassword>@127.0.0.1:8332',},redis: {port: 6379,host: '127.0.0.1',family: 4,password: 'password',db: 0,},lnd: {url: '127.0.0.1:<LND gRPC port>',password: '',},};if (process.env.CONFIG) {console.log('using config from env');config = JSON.parse(process.env.CONFIG);}module.exports = config;

Step 3— Redis

Redis is the datastore for LndHub.

3A —Install Redis, then create the working directory inside the LndHub folder

brew install redis
sudo mkdir redis

3B — Edit the redis.conf file

sudo nano /usr/local/etc/redis.conf

Change the supervision supervised systemd :

Change the working directory to dir /Users/<user>/LndHub/redis :

Get stuck? Additional tutorial here: https://medium.com/@petehouston/install-and-config-redis-on-mac-os-x-via-homebrew-eb8df9a4f298

Step 4— Deploy with NPM and Babel

Finalise LndHub configuration and deploy. Ensure you are back in your main LndHub directory (/User/<user>/LndHub)

4A — Install Node, and then check versions

brew install nodenode -v
npm -v

4B — Install node modules

npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install

4C — Compile babeljs

npm install -g babel-cli
mkdir build
babel ./ --out-dir ./build --copy-files --ignore node_modules

4D — Run LndHub

node build/index.js

Check for 'BOOTING UP' 'Listening on port 3000'

Head to http://127.0.0.1:3000/ to now see LndHub running.

Step 5— Port Forward

Since LndHub is running locally, we need to forward external ports.

5A — Head to 192.168.0.1 in your browser, and enter your router username and password. Google it if you don’t know, but normally admin:password

5B — Find your computer’s MAC and IP address (displayed in “devices” or “overview”). Also can use ifconfig to get MAC and ipconfig getifaddr en0 to get local IP in terminal.

5C — Navigate to “Games and Services” to find “Port Forwarding” and add your LndHub as a forwarded port on 3000. My local IP was 192.168.0.13

5C — Navigate to “LAN” and then locate the “DHCP Reservation Lease” pane. Bind your Local IP to your MAC Address:

All this is doing is forwarding external requests on port 3000 direct to your local IP and directly to your Mac’s Address.

Now find your external IP address (google “what’s my IP” if you don’t know), and add port 3000 in your browser:

http://<YOUR-IP-ADDRESS>:3000/

LndHub Running!

Step 6— Connect to BlueWallet

Now head to BlueWallet and add the above url to in Lightning Settings. You are self-sovereign!

This tutorial is a work in progress.

ToDo: Add a launchd startup plist for auto-start for lnd

--

--