All Extras / Simultaneous mainnet & testnet

IMPORTANT !

These instructions have NOT been tested where the Raspibolt had existing Bitcoins in the mainnet wallet.

Do not follow these instructions unless your Raspibolt mainnet Bitcoin wallet and channel balances are zero - otherwise you may loose all those Bitcoins.

Introduction

Difficulty: Hard

There is no reason that you can not run both mainnet & testnet lnd instances at the same time on one RaspiBolt. These instructions assume you have a working RaspiBolt running successfully and you can successfully switch between mainnet and testnet mode as below.

Resources

Is the RaspiBolt 'big' enough to handle both instances? Good question.

My RaspiBolt is a Model 3B with these specs:

CPU: 64 bit QuadCore
RAM: 1 GB, with SWAP enabled on HDD
HDD: USB connected, 1 TByte
Power Supply: 2.5A, 5V USB connector
Cooling: Stick-on heatlinks & Fan

Here is what I see on my RaspiBolt with both running.

RAM free: 312MB (of 976MB)
- Occasionally drops to 60 ~ 80 MB for short periods
CPU:
- Load ave = 0.68. (17% of 4 CPUs)
- Temp: 38 degC
HDD: 26% (of 1TB) used.
- When testnet block height = 1356550
- When mainnet block height = 534762

LND Version

This documentaion is based on LND V0.4.2-Beta.

The biggest hurdle I faced is that while bitcoind seems quite happy with both testnet and mainnet under the same top-level folder, lnd wasn't.

A DIAGRAM TO MAKE THINGS CLEARER

After completing these instructions here, the 4 instances shown will be operating on the ports shown below.

PROCEDURE

File Locations

() = default

	bitcoind mainnet	lnd mainnet	bitcoind testnet	lnd testnet
data root `[1]`	(.bitcoin)	(.lnd/data)	(.bitcoin/testnet3)	.lnd/testnet/data
conf file`[1]`	(.bitcoin/bitcoin.conf)	(.lnd/lnd.conf)	.bitcoin/testnet3/bitcoin.conf	.lnd/testnet/lnd.conf
service file `[2]`	bitcoind.service	lnd.service	bitcoind_testnet.service	lnd_testnet_service

[1] relative to /home/bitcoin/

[2] relative to /etc/systemd/system/

Overview

Open new firewall ports
Shutdown existing services
Make testnet3 directory for lnd
New conf files
New services
Enable and start new services
cli Aliases

Open New Firewall Ports

Open new ports in RaspiBolt

admin ~ ฿ sudo su

$ ufw allow 19735  comment 'allow Lightning testnet'
$ ufw allow 18333  comment 'allow Bitcoin testnet'
$ ufw status
$ exit

Click to see ufw status

root@RaspiBolt:/home/admin# ufw status
Status: active

To                         Action      From
--                         ------      ----
22                         ALLOW       192.168.0.0/24             # allow SSH from local LAN
9735                       ALLOW       Anywhere                   # allow Lightning mainnet
8333                       ALLOW       Anywhere                   # allow Bitcoin mainnet
18333                      ALLOW       Anywhere                   # allow Bitcoin testnet
19735                      ALLOW       Anywhere                   # allow Lightning testnet
9735 (v6)                  ALLOW       Anywhere (v6)              # allow Lightning mainnet
8333 (v6)                  ALLOW       Anywhere (v6)              # allow Bitcoin mainnet
18333 (v6)                 ALLOW       Anywhere (v6)              # allow Bitcoin testnet
19735 (v6)                 ALLOW       Anywhere (v6)              # allow Lightning testnet

Open new port in Router

Review the Raspberry Pi guide from Stadicus. Go to the Accessing your router section and add this port forwarding:

Application name	External port	Internal port	Internal IP address	Protocol (TCP or UDP)
19375	19375	`<Raspibolt IP>`	`<Raspibolt IP>`	BOTH
18333	18333	`<Raspibolt IP>`	`<Raspibolt IP>`	BOTH

Shutdown existing services

admin ~  ฿  sudo systemctl stop lnd
admin ~  ฿  sudo systemctl stop bitcoind

Make testnet Directory for lnd

admin /home/bitcoin/.lnd  ฿  cd /home/bitcoin/.lnd
admin /home/bitcoin/.lnd  ฿  sudo mkdir testnet
admin /home/bitcoin/.lnd  ฿  sudo chown bitcoin:bitcoin testnet
admin /home/bitcoin/.lnd  ฿  sudo cp -p *.macaroon testnet
admin /home/bitcoin/.lnd  ฿  sudo cp -p tls.* testnet
admin /home/bitcoin/.lnd  ฿  sudo cp -pr data testnet
admin /home/bitcoin/.lnd  ฿  ls testnet
total 36
drwxr-xr-x 4 bitcoin bitcoin 4096 Apr 16 17:25 .
drwxr-xr-x 5 bitcoin bitcoin 4096 Apr 16 16:58 ..
-rw------- 1 bitcoin bitcoin  232 Apr  8 14:29 admin.macaroon
drwx------ 4 bitcoin bitcoin 4096 Apr  8 14:25 data
-rw-r--r-- 1 bitcoin bitcoin  115 Apr  8 14:29 invoice.macaroon
drwx------ 3 bitcoin bitcoin 4096 Apr  2 11:20 logs
-rw-r--r-- 1 bitcoin bitcoin  183 Apr  8 14:29 readonly.macaroon
-rw-r--r-- 1 bitcoin bitcoin  741 Apr  8 19:45 tls.cert
-rw------- 1 bitcoin bitcoin  227 Apr  8 19:45 tls.key

New conf files

Create or update the files below.

The command to use is:

admin ~ ฿ sudo nano <filename>

Don't forget to Edit these lines as needed:

bitcoin.conf files: rpcpassword=PASSWORD_[B]
lnd.conf files: alias=YOUR_NAME [LND]

Click to see /home/bitcoin/.bitcoin/bitcoin.conf

# RaspiBolt LND  bitcoind configuration
# /home/bitcoin/.bitcoin/bitcoin.conf

zmqpubrawblock=tcp://127.0.0.1:29000
zmqpubrawtx=tcp://127.0.0.1:29000

# Bitcoind options
server=1
daemon=1
txindex=1
disablewallet=1

# Connection settings
rpcuser=raspibolt
rpcpassword=PASSWORD_[B]

# Raspberry Pi optimizations
dbcache=100
maxorphantx=10
maxmempool=50
maxconnections=40
maxuploadtarget=5000

Click to see /home/bitcoin/.bitcoin/testnet3/bitcoin.conf

# RaspiBolt LND  bitcoind configuration
# /home/bitcoin/.bitcoin/testnet3/bitcoin.conf

testnet=1
zmqpubrawblock=tcp://127.0.0.1:28332
zmqpubrawtx=tcp://127.0.0.1:28332

# Bitcoind options
server=1
daemon=1
txindex=1
disablewallet=1

# Connection settings
rpcuser=raspibolt
rpcpassword=PASSWORD_[B]

# Raspberry Pi optimizations
dbcache=100
maxorphantx=10
maxmempool=50
maxconnections=40
maxuploadtarget=5000

Click to see /home/bitcoin/.lnd/lnd.conf

# RaspiBolt LND Mainnet: lnd configuration
# /home/bitcoin/.lnd/lnd.conf

[Application Options]
debuglevel=info
debughtlc=true
maxpendingchannels=5
alias=YOUR_NAME [LND]
color=#68F442

[Bitcoin]
bitcoin.active=1

# enable either testnet or mainnet
#bitcoin.testnet=1
bitcoin.mainnet=1

bitcoin.node=bitcoind

#[Bitcoind]
#bitcoind.zmqpath=tcp://127.0.0.1:29000

[autopilot]
autopilot.active=1
autopilot.maxchannels=5
autopilot.allocation=0.6

Click to see /home/bitcoin/.lnd/testnet/lnd.conf

# RaspiBolt LND Testnet: lnd configuration
# /home/bitcoin/.lnd/testnet/lnd.conf

[Application Options]
debuglevel=info
debughtlc=true
maxpendingchannels=5
alias=YOUR_NAME [LND]
color=#68F442

datadir=/home/bitcoin/.lnd/testnet/data
logdir=/home/bitcoin/.lnd/testnet/logs
listen=0.0.0.0:19735

[Bitcoin]
bitcoin.active=1

# enable either testnet or mainnet
bitcoin.testnet=1
#bitcoin.mainnet=1

bitcoin.node=bitcoind

[Bitcoind]
bitcoind.zmqpath=tcp://127.0.0.1:28332

[autopilot]
autopilot.active=1
autopilot.maxchannels=5
autopilot.allocation=0.6

New services

Create or update the files below.

The command to use is:

admin ~ ฿ sudo nano <filename>

Click to see /etc/systemd/system/bitcoind.service

# RaspiBolt LND Mainnet: systemd unit for bitcoind
# /etc/systemd/system/bitcoind.service

[Unit]
Description=Bitcoin daemon
Wants=getpublicip.service
After=getpublicip.service

# for use with sendmail alert (coming soon)
#OnFailure=systemd-sendmail@%n

[Service]
User=bitcoin
Group=bitcoin
Type=forking
PIDFile=/home/bitcoin/.bitcoin/bitcoind.pid
ExecStart=/usr/local/bin/bitcoind
KillMode=process
Restart=always
TimeoutSec=120
RestartSec=30

[Install]
WantedBy=multi-user.target

Click to see /etc/systemd/system/bitcoind_testnet.service

# RaspiBolt LND Testnet: systemd unit for bitcoind
# /etc/systemd/system/bitcoind_testnet.service

[Unit]
Description=Bitcoin Testnet daemon
Wants=getpublicip.service
After=getpublicip.service

# for use with sendmail alert (coming soon)
#OnFailure=systemd-sendmail@%n

[Service]
User=bitcoin
Group=bitcoin
Type=forking
PIDFile=/home/bitcoin/.bitcoin/testnet3/bitcoind.pid
ExecStart=/usr/local/bin/bitcoind -testnet
KillMode=process
Restart=always
TimeoutSec=120
RestartSec=30

[Install]
WantedBy=multi-user.target

Click to see /etc/systemd/system/lnd.service

# RaspiBolt LND Mainnet: systemd unit for lnd
# /etc/systemd/system/lnd.service

[Unit]
Description=LND Lightning Daemon
Wants=bitcoind.service
After=bitcoind.service

# for use with sendmail alert
#OnFailure=systemd-sendmail@%n

[Service]
# get var PUBIP from file
EnvironmentFile=/run/publicip

ExecStart=/usr/local/bin/lnd --configfile=/home/bitcoin/.lnd/lnd.conf --externalip=${PUBLICIP}:19735
User=bitcoin
Group=bitcoin
LimitNOFILE=128000
Type=simple
KillMode=process
TimeoutSec=180
Restart=always
RestartSec=60

[Install]
WantedBy=multi-user.target

Click to see /etc/systemd/system/lnd_testnet.service

# RaspiBolt LND Testnet: systemd unit for lnd
# /etc/systemd/system/lnd_testnet.service

[Unit]
Description=LND Lightning Daemon
Wants=bitcoind.service
After=bitcoind.service

# for use with sendmail alert
#OnFailure=systemd-sendmail@%n

[Service]
# get var PUBIP from file
EnvironmentFile=/run/publicip
ExecStart=/usr/local/bin/lnd  --configfile=/home/bitcoin/.lnd/testnet/lnd.conf --externalip=${PUBLICIP}:19735
User=bitcoin
Group=bitcoin
LimitNOFILE=128000
Type=simple
KillMode=process
TimeoutSec=180
Restart=always
RestartSec=60

[Install]
WantedBy=multi-user.target

Enable and start new services

admin ~  ฿  sudo systemctl enable bitcoind
admin ~  ฿  sudo systemctl enable bitcoind_testnet
admin ~  ฿  sudo systemctl enable lnd
admin ~  ฿  sudo systemctl enable lnd_testnet
admin ~  ฿  sudo systemctl start bitcoind
admin ~  ฿  sudo systemctl start bitcoind_testnet
admin ~  ฿  sudo systemctl start lnd
admin ~  ฿  sudo systemctl start lnd_testnet

cli Aliases

To simplify accessing the 4 daemons from the command line, setup these 4 aliases for the admin account.

admin ~ ฿ sudo nano /home/admin/.bash_aliases

alias bcm='bitcoin-cli -datadir=/home/bitcoin/.bitcoin'
alias bct='bcm -testnet'
alias lcm='lncli  \
              --macaroonpath=/home/admin/.lnd/admin.macaroon \
              --tlscertpath=/home/admin/.lnd/tls.cert'
alias lct='lncli  --rpcserver localhost:11009'

To test these are working OK:

Logout of admin
Login to admin
Enter commands as below

admin ~  ฿  bcm getblockchaininfo
...
  "chain": "main"
...
admin ~  ฿  bct getblockchaininfo
...
  "chain": "test",
...
admin ~  ฿  lcm unlock
Input wallet password:


admin ~  ฿  lct unlock
Input wallet password:

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

RB_extra_03.md

RB_extra_03.md

IMPORTANT !

Introduction

Resources

LND Version

A DIAGRAM TO MAKE THINGS CLEARER

PROCEDURE

File Locations

Overview

Open New Firewall Ports

Shutdown existing services

Make testnet Directory for lnd

New conf files

New services

Enable and start new services

cli Aliases

Files

RB_extra_03.md

Latest commit

History

RB_extra_03.md

File metadata and controls

IMPORTANT !

Introduction

Resources

LND Version

A DIAGRAM TO MAKE THINGS CLEARER

PROCEDURE

File Locations

Overview

Open New Firewall Ports

Shutdown existing services

Make testnet Directory for lnd

New conf files

New services

Enable and start new services

cli Aliases