But before you start, check out my other tutorial on how to install LND on Bitcoin mainnet first if you haven't already.
I run a remote Lightning node on my Linux server and Zap Wallet on Mac OS.
However, the tutorial will work for any kind of setup as long as the operating systems are UNIX-like. Sorry, no Windows.
Please note, that there are still many features that are exclusive to Bitcoin testnet network. Running Zap with mainnet isn't recommended at this point, unless you feel #reckless.
Make sure you run node.js >= 8, npm >= 5 and yarn:
If you use a package manager for Linux, visit these instructions for node.js instead.
Install Zap Wallet
Create a source folder if you don't have it already:
Clone the Zap Wallet from Tom Kirkpatrick's repository:
git clone https://github.com/mrfelton/zap-desktop.git
Switch to the
connection onboarding branch:
git checkout feaure/connection-onboarding
Install Zap dependencies with yarn and grpc with npm.
npm run install-grpc
Be patient, it may take a few minutes to finish.
Run Zap Wallet
Test that everything has been installed correctly:
npm run test
If the above command fails on a "The renderer process is not built yet." error, run this command first:
npm run build-renderer
npm run dev
Alternatively, you may build a binary package for your OS:
npm run package
The package will be located in
~/source/zap-desktop/release however, I haven't had luck running it without errors.
Allow incoming connections for a remote grpc (optional)
If your Lightning node runs on a different machine as Zap, you will have to make it accept incoming connections.
Go to your server and add the following line to
Next, open the port on your firewall:
sudo iptables -A INPUT -p tcp --dport 10009 -j ACCEPT
I only want my node's grpc to be accessible on the local network. But if you want to be able to connect remotely and your server is behind a router, you will have to setup port forwarding on the router too.
When finished, restart your node:
sudo service lnd stop
sudo service lnd start
Connect to your node
tls.cert files. If the LND node runs on a remote server, copy them to your local machine.
Start the wallet if you haven't already and when prompted for Lightning Connection, choose Custom and click Next.
In the next step, you will have to setup your Connection Details. and point Zap to the TLS certificate (tls.cert) and Macaroon (admin.macaroon). Make sure to use absolute paths to the files.
If LND runs locally add 127.0.0.1:10009 as your host, otherwise choose the server's IP address or host followed by the port.
Go to the next step and within a few seconds, you will be connected to your node and ready to use Zap.
If you've previously opened channels and made some transactions you'll see them in Zap immediately.