Deploy lnd to Google Cloud

To use the wallet you need deploy your own LND. To make it available always and everywhere, we suggest deploying it on a remote server.

This tutorial will guide you with step-by-step instructions on how to accomplish this task with the help of Google cloud.

1. Sign up for Google cloud or sign in if you already have an account there. You can start free trial and get $300 credit to spend on Google Cloud Platform over the next 12 months. To receive the credit you need to specify your credit card details. Google asks you for your credit card to make sure you are not a robot. You won’t be charged unless you manually upgrade to a paid account.

2. Take the following steps to enable the Kubernetes Engine API:

   2.1. Visit the Kubernetes Engine page in the Google Cloud Platform Console.

   2.2. Create or select a project.

   2.3. Wait for the API and related services to be enabled. This can take several minutes.

   2.4. Make sure that billing is enabled for your project.

3. Go to Activate Cloud Shell.

4. Create container cluster

   gcloud container clusters create lnd-cluster --zone=europe-west1-b --num-nodes=1   
   

   It may take several minutes for the cluster to be created.

   NOTE: If you need a node in another zone specify desired value in the command for container cluster creation. To get list with all possible zones use:

   gcloud compute zones list
   

You can run your node on mainnet or testnet. You need to chose only one option.

Mainnet

1. Clone config to deploy your lnd and deploy it:

   git clone https://github.com/LightningPeach/lnd-gc-deploy.git
   cd lnd-gc-deploy
   sed -i "s/volumepath/\/home\/$USER\/.lnd/g" lnd-volume.yml
   kubectl create -f lnd-volume.yml
   kubectl create -f lnd-claim.yml 
   kubectl create -f lnd-pod.yml
   kubectl create -f lnd-service.yml
   

2. Wait for a port to be exposed. To check the status run:

   kubectl get services
   

   and find "lnd-pod" service. If external ip is not <pending> you can continue.

3. Create new tls certificate which is valid for your ip and for your lnd:

   ./rebuild-tls.sh
   

4. Restart you lnd:

   kubectl create -f lnd-pod.yml
   

5. Create a wallet inside lnd:

   kubectl exec -it lnd-pod -- bash
   ./lncli.sh create
   

   You should create a password for the wallet.

   If you don't have a bitcoin wallet, type that you don't have seeds (n). You will get your seed words. You need to keep seed words in secret and save it somewhere for wallet recovery or moving to a new device. You can also create a password for seed words if you want.

   If you already have a bitcoin wallet and want to use all balances from your wallet in the lnd, type your seed phrase.

   After creating wallet exit from the container:

   exit
   

6. You can get data to connect lnd in 2 ways:

   6.1 By generating qr code and scanning it from mobile.

   To generate qr run:

   sudo apt-get install -y qrencode
   ./display-qr.sh
   

   NOTE: To zoom out qr code, you can zoom out the browser page (for example, with the help of combination "ctrl/command" + "-").

   6.2 By getting all data manualy and adding it to input fields.

   Get your external IP (fourth column) for service lnd-pod by running:

   ./show-host.sh
   

   You can copy and paste it as host to your signup form in the LightningPeach wallet.

   To get tls.cert run:

   kubectl exec lnd-pod -- cat /root/.lnd/tls.cert
   

   To get macaroon hex run:

   kubectl exec lnd-pod -- xxd -p /root/.lnd/data/chain/bitcoin/mainnet/admin.macaroon | tr -d '[:space:]'
   

   You must keep macaroons and QR codes in secret. Providing them to third parties will give others full access to your funds.

Testnet

1. Clone config to deploy your lnd and deploy it:

   git clone https://github.com/LightningPeach/lnd-gc-deploy.git
   cd lnd-gc-deploy
   sed -i "s/volumepath/\/home\/$USER\/.lnd/g" lnd-volume.yml
   kubectl create -f lnd-volume.yml
   kubectl create -f lnd-claim.yml 
   kubectl create -f lnd-pod-testnet.yml
   kubectl create -f lnd-service.yml
   

2. Wait for a port to be exposed. To check the status run:

   kubectl get services
   

   and find "lnd-pod" service. If external ip is not <pending> you can continue.

3. Create new tls certificate which is valid for your ip and for your lnd:

   ./rebuild-tls.sh
   

4. Restart you lnd:

   kubectl create -f lnd-pod-testnet.yml
   

5. Create a wallet inside lnd:

   kubectl exec -it lnd-pod -- bash
   ./lncli-testnet.sh create
   

   You should create a password for the wallet.

   If you don't have a bitcoin wallet, type that you don't have seeds (n). You will get your seed words. You need to keep seed words in secret and save it somewhere for wallet recovery or moving to a new device. You can also create a password for seed words if you want.

   If you already have a bitcoin wallet and want to use all balances from your wallet in the lnd, type your seed phrase.

   After creating wallet exit from the container:

   exit
   

6. You can get data to connect lnd in 2 ways:

   6.1 By generating qr code and scanning it from mobile.

   To generate qr run:

   sudo apt-get install -y qrencode
   ./display-qr-testnet.sh
   

   NOTE: To zoom out qr code, you can zoom out the browser page (for example, with the help of combination "ctrl/command" + "-").

   6.2 By getting all data manualy and adding it to input fields.

   Get your external IP (fourth column) for service lnd-pod by running:

   ./show-host.sh
   

   You can copy and paste it as host to your signup form in the LightningPeach wallet.

   To get tls.cert run:

   kubectl exec lnd-pod -- cat /root/.lnd/tls.cert
   

   To get macaroon hex run:

   kubectl exec lnd-pod -- xxd -p /root/.lnd/data/chain/bitcoin/testnet/admin.macaroon | tr -d '[:space:]'
   

   You must keep macaroons and QR codes in secret. Providing them to third parties will give others full access to your funds.

How to restart lnd

If you want to restart your lnd you need to run:

kubectl delete pod lnd-pod

wait until lnd pod is deleted and then run lnd

• for mainnet

  kubectl create -f lnd-pod.yml
  

  wait while lnd is creating and run

  kubectl exec -it lnd-pod -- bash
  ./lncli.sh unlock
  

  and type the password you used for lnd. Exit from the container:

  exit
  

• for testnet

  kubectl create -f lnd-pod-testnet.yml
  

  wait while lnd is creating and run

  kubectl exec -it lnd-pod -- bash
  ./lncli-testnet.sh unlock
  

  and type the password you used for lnd. Exit from the container:

  exit
  

Deployment on own server

Also you can deploy LND on your own from docker container. You will need to open ports 9735 (for peer access), and 8080 (for managing from a smartphone).