Bewerken van Umbrel lightning node

Umbrel is één van de makkelijkste manieren om een [[Lightning]] node te beginnen!

== Installeren ==
De podcast [[Satoshi Radio#Nodezaak]] heeft goeie instructies hoe Umbrel op te zetten. Umbrel is een [[Bitcoin node]] en Lightning node in één.

De stappen zijn grofweg:
# Koop [[Lightning#Hardware|#Hardware]], verbind je USB-power, schijf (SSD of HDD), monteer de koeling
# Zet Umbrel op je SD-kaart, dit noemen we "flashen" en wordt in de podcast [[Satoshi Radio#Nodezaak|nodezaak]] precies uitgelegd.
# Start de node! Geen kennis van linux nodig.

== Apps ==
Umbrel heeft een ingebouwde appstore die het makkelijk maakt om extra functionaliteiten uit je node te halen.
{| class="wikitable"
|+Apps in de Umbrel appstore
! Naam
!Beschrijving
|-
|[[Mempool.space]]
|Een lokale blokexplorer die de data gebruikt van je node
|-
|BTC RPC Explorer
|Een lokale [[Links#Block explorers|blokexplorer]] die de data gebruikt van je node
|-
|[[Samourai|Samourai Server]]
|Een eigen server voor de Samourai Wallet
|-
|[[Specter|Specter Desktop]]
|Een wallet die het makkelijkt maakt om bijvoorbeeld een multisig setup te maken
|-
|[[Sphinx Relay]]
|Een applicatie die het mogelijk maakt om te chatten via het lightning netwerk en streaming payments implemeteert voor podcasts.
|-
|[[RTL|Ride the Lightning]]
|Een grafische interface om je lightning node te beheren.
|-
|[[Lightning Terminal]]
|Een grafische interface om je lightning node te beheren. Ook is het mogelijk om inkomende liquiditeit te kopen en uitgaande liquiditeit verkopen doormiddel van Lightning pool.
|-
|[[ThunderHub]]
|Een grafische interface om je lightning node te beheren.
|-
|[[LNbits]]
|Een open-source lightning wallet die het mogelijk maakt om meerdere lightningwallets te gebruiken op één node.
|-
|[[BTCPayServer|BTCPay Server]]
|Een paymentprocesor die het mogelijk maakt om Bitcoin en Lightning te accepteren zonder tussenkomst van een 3e partij.
|}
== Acties ==
Er zijn verschillende acties die je kan doen met je Umbrel node. Hieronder staan er een aantal uitgelegd.

=== Je node key vinden (Node Key / Lightning Address / URI) ===
[[Bestand:Umbrel-Lightning-Address.jpg|miniatuur|Rechtsboven krijg je de optie "Lightning Address"]] 
De termen Node Key, Node Pubkey, Lightning Address, Node ID en URI worden door elkaar heen gebruikt. Een node key ziet eruit als '''03e691f81f08c56fa876cc4ef5c9e8b727bd682cf35605be25d48607a802526053''' @ '''ug6wkjdnp5fq2iiyakjn7uewn2eyghpqyapzkgvh7hbsq6acmxtt6lqd.onion:9735'''. Het deel voor de @ is de node key. Het deel na de @ is de verbindingsinformatie.

In het Lightningscherm van Umbrel moet je op de 3 puntjes klikken (zie ook het plaatje) om je Lightning Address te vinden.

=== Kanaal openen ===
Uitgaande van een eigen Umbrel node als hierboven beschreven, onderstaand de mogelijke stappen om een kanaal te openen met een andere node. Om een kanaal te openen dient er een on-chain Bitcoin transactie plaats te vinden. (En voor het sluiten ook weer). Voor de gewone individu is het daarom aan te raden met slechts 1 andere node een kanaal te openen, en dan nog wel met een 'grote' node, dat wil zeggen een node met veel liquiditeit en veel uitgaande connecties. Dat laatste is belangrijk om een gewenste lightning transactie zo'n groot mogelijke slagingskans te geven.

De volgende stappen zijn gebaseerd op de video-serie [https://youtu.be/ROiaj5AT7HI?t=239 'Nodezaak' te zien op YouTube], vanaf minuut 4.

* Zorg dat er voldoende saldo op de Bitcoin Core node staat, bijvoorbeeld €250,-.
* Liever één groot kanaal dan meerdere kleine, bijvoorbeeld €100,- of €200,-.
* Ga in browser naar [https://1ml.com/ 1ml.com].
* Zoek node Lightning.Watch (https://1ml.com/node/03e691f81f08c56fa876cc4ef5c9e8b727bd682cf35605be25d48607a802526053).
* Kopieer Public Key inclusief @-deel (2e regel: 03e691f81f08c56fa876cc4ef5c9e8b727bd682cf35605be25d48607a802526053@188.166.81.82:9735).
Ga naar Umbrel scherm
* Kies Lightning uit het menu links.
* Kies recht "+OPEN CHANNEL".
* Plak in Lightning Address.
* Geef de gewenste waarde in Satoshis in, bijvoorbeeld ter waarde van €100,-.
* Stel de transaction fee in: stel in op lage waarde, bijv $2 en heb geduld (of stel hoger in voor snellere satisfactie)
* Klik groene knop OPEN CHANNEL.

Wacht nu geduldig tot Active Channels op 1 springt en Max Send op het bedrag dat je geladen had; Het lijkt meteen of je kanaal 'geladen' is, maar afhankelijk van je fee zal je moeten wachten.

Er is nu een kanaal tussen je Umbrel LN en de Lightning.watch LN. De capaciteit zit vast in het kanaal en is in mindering gebracht op je btc-saldo bij Bitcoin Core;

=== Wallet koppelen ===
Vanuit de interface van Umbrel kun je makkelijk Lightning invoices maken en betalen, maar het is ook mogelijk om dit met een mobiele app te doen. De makkelijkste wallet om mee te werken is Zeus. Zeus is voor zowel [https://play.google.com/store/apps/details?id=app.zeusln.zeus Android] ([https://github.com/ZeusLN/zeus/releases APK]) als [https://apps.apple.com/us/app/zeus-ln/id1456038895 iOS] beschikbaar en is open-source. De UX ziet er voor beide hetzelfde uit, dus de stappen blijven gelijk.

Ga naar Umbrel scherm

* Kies "Connect Wallet"
* Selecteer Zeus
* Open Zeus op je telefoon
* Kies "Scan lndconnect config"
* Scan de QR-code weergeven in je Umbrel interface
* Vink "Use Tor" en "Certificate Verification" beide aan (de laatste is niet noodzakelijk, maar een extra beveiliging) en druk op "Save Node Config"

Na een paar seconden zie je alle info in de app verschijnen en kun je zowel Bitcoin als Lightning betalingen doen en Lightning kanalen beheren rechtstreeks vanaf je eigen node waar je ook bent.

=== Inloggen via SSH ===
Een hoop commando's dienen via SSH te gebeuren. Dit is een manier om je node te beheren via een tekst-interface.

==== Vanaf een Windows 10-computer ====
Open PowerShell (WIN-R, powershell, enter) en typ onderstaand commando. Als het niet werkt, download dan [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html PuTTY].
<pre>ssh -t umbrel@umbrel.local</pre>
Voer het wachtwoord in (zelfde als inlogwachtwoord van de webpagina), je zal niet zien ''dat'' je het wachtwoord aan het invoeren bent.

==== Vanaf een Mac of Linux-computer ====
Open je Terminal en typ onderstaand commando:
<pre>ssh -t umbrel@umbrel.local</pre>
Voer het wachtwoord in (zelfde als inlogwachtwoord van de webpagina), je zal niet zien ''dat'' je het wachtwoord aan het invoeren bent.

=== Alias (naam) en kleur instellen ===
Wil je een alias instellen voor je node? Besef eerst dat de informatie publiek wordt! 

Let op: op dit moment wordt bij elke update de LND configuratie teruggezet naar de standaardinstellingen en zal je je alias opnieuw moeten invoeren.

# Log in op je node via SSH 
# Open het config bestand: '''nano umbrel/lnd/lnd.conf'' (dat is LND klein geschreven, niet iND). 
# U bent nu in de editor. Voeg '''alias=SOMENAME''' toe. Dit moet worden toegevoegd aan de eerste paragraaf. Ergens onder het blok '''[Application Options]''', niet in een ander blok. 
# (Optioneel) zet '''color=#ff0000''' of een andere hex kleur, op een nieuwe regel, net onder alias. [https://www.color-hex.com/ vind een mooie kleur].
# Onderaan zie je de commando's die je kunt geven. Het dakje '''^''' betekent CTRL toets. '''^X'' is eXit, dus gebruik CTRL-X om het bestand te verlaten. Bevestig dat je de buffer wilt opslaan met Y. Druk enter voor de bestandsnaam (niet veranderen).
# Nadat je de editor hebt verlaten, type '''cat umbrel/lnd/lnd.conf'' om naar de inhoud van het bestand te kijken.
# Start vervolgens de Umbrel node opnieuw op. Je kunt dit goed doen vanuit de Umbrel webinterface (Instellingen, Herstart)
# Als je publieke kanalen hebt, duurt het (max) 2 dagen voordat de nieuwe node zichtbaar is op [https://1ml.com 1ml.com]. 
# Als je [[RTL]] geïnstalleerd hebt, zou je de nieuwe node naam direct moeten zien na een herstart van RTL, of na opnieuw in te loggen. Een schone herstart van een node (via de webinterface) zou RTL ook opnieuw moeten starten.

Als je terminal bevriest, heb je misschien CTRL-S ingedrukt. Maak het bevriezen ongedaan met CTRL-Q.

=== Bekijken hoe veel routes je node kent ===
Log in via SSH en doe daarna

<code>docker exec -i lnd lncli describegraph | grep channel_id | wc -l</code>

Je krijgt het aantal kanalen terug, dit moeten er zeker meer dan 35 000 zijn. Zo niet, dan moet je nog even wachten totdat je node via het [[Lightning#Concepten|roddelcircuit]] de kanalen doorkrijgt. Het is hiervoor nodig dat je minstens 1 actief kanaal hebt en het kan tot 2 dagen duren. Hoe meer kanalen, hoe sneller het gaat.

=== Eerder gedownloade blockchaindata gebruiken ===

Mocht je overstappen van andere nodesoftware of heb je de bitcoin blockchain al eerder gedownload, dan kan je deze overzetten op je nieuwe installatie. Dit scheelt je de blockhaindata opnieuw downloaden.
Bron: Umbrel GitHub [https://github.com/getumbrel/umbrel-os/issues/119]

# Zorg dat je de installatie hebt voltooid en Umbrel al een keer hebt opgestart met de externe schijf aangesloten.
# Sluit Umbrel af via de Settings pagina, haal de stekker uit het stopcontact en verwijder de externe schijf.

Omdat de externe schrijf nu als EXT4 geformatteerd is, kan deze niet in Windows / macOS gelezen worden. 
Als je geen linux hebt, kan je ook een Virtual Machine (VM) gebruiken of een live CD/USB. De live optie heeft bijna elke desktop installatie , zoals "Raspberry Pi Desktop for PC and Mac" [https://www.raspberrypi.org/software/]. Maak een VM aan in VirtualBox of zet hem op een USB stick.

# Kopieer de mappen "blocks" en "chainstate" van de eerdere installatie en plaats/vervang ze in /umbrel/bitcoin/ op je externe schijf.
# Ontkoppel de externe schijf, verbind hem weer met je nieuwe Umbrel node en start deze weer op.
# De blockchaindata wordt gecontroleerd voordat hij gebruikt kan worden, dus het kan even duren voordat je het inlogscherm te zien krijgt.

=== Ruimtegebrek op een custom install ===
Mocht je Umbrel niet op een Raspberry Pi hebben geïnstalleerd en je komt er later achter dat ruimte tekort komt, dan is het verplaatsen van de blockchaindata naar een andere locatie en optie (bijvoorbeeld een externe schijf). Zo hoef je niet opnieuw te beginnen met downloaden.

Stop Umbrel

<code>cd /INSTALLATIEMAP/UMBREL</code> bijvoorbeeld <code>cd /home/gebruiker/umbrel</code>

<code>sudo ./scripts/stop</code>

Kopieer de mappen "blocks" en "chainstate" naar een nieuwe locatie.

<code>cp -r /ORIGINEEL/umbrel/bitcoin/blocks /NIEUW/umbrel/blocks</code>

<code>cp -r /ORIGINEEL/umbrel/bitcoin/chainstate /NIEUW/umbrel/chainstate</code>

Bijvoorbeeld
<code>cp -r /home/gebruiker/umbrel/bitcoin/blocks /mnt/harddisk/umbrel/blocks</code>

Controleer of er geen verschil is tussen de nieuwe en oude mappen. Bij geen antwoord is er geen verschil.

<code>diff -qr /ORIGINEEL/umbrel/bitcoin/blocks /NIEUW/umbrel/blocks</code>

<code>diff -qr /ORIGINEEL/umbrel/bitcoin/chainstate /NIEUW/umbrel/chainstate</code>

Verwijder de originele mappen als je hebt bevestigd dat de nieuwe map niet verschillend is.

<code>rm -r /ORIGINEEL/umbrel/bitcoin/blocks</code>

<code>rm -r /ORIGINEEL/umbrel/bitcoin/chainstate</code>

Verwijs naar de nieuwe plek op de originele locatie met een symbolische of softlink

<code>ln -s /NIEUW/umbrel/blocks /ORIGINEEL/umbrel/bitcoin/blocks</code>

<code>ln -s /NIEUW/umbrel/chainstate /ORIGINEEL/umbrel/bitcoin/chainstate</code>

Controleer of de symbolische link goed gelukt is. Het komt er in een andere kleur te staan, met het symbool ->

<code>ls -la /ORIGINEEL/umbrel/bitcoin</code>

Reboot en enjoy the free disk space!

<code>sudo reboot</code>

=== Een handmatige update doen ===
Als je Umbrel blijft [https://github.com/getumbrel/umbrel/issues/593#issuecomment-787518502 hangen], dan kan je een handmatige update doen. 

Log in via SSH (zie hierboven) en doe:

<code>cd ~/umbrel && sudo scripts/update/update --repo getumbrel/umbrel</code>

Umbrel zal nu updaten naar de laatste versie.

=== Bitcoin-cli commando's draaien ===
Verbind via SSH (ssh umbrel@umbrel.local) met je Umbrel node. Je kunt je bitcoin-cli commando's uitvoeren met <code>docker exec -i bitcoin bitcoin-cli</code>

=== LND-cli commando's draaien ===
Verbind via SSH (ssh umbrel@umbrel.local) met je Umbrel node. Je kunt je lncli commando's uitvoeren met <code>docker exec -i lnd lncli</code>

Bijvoorbeeld de status van je node
<pre>docker exec -i lnd lncli getinfo</pre>

=== Een bericht tekenen ===
Dit kan via de [[RTL]]-app, of op de commandline (via SSH):

Log in via SSH (zie boven) en doe:

<code>docker exec -i lnd lncli signmessage HETBERICHT</code>

Je krijgt dan je signature terug, hij staat tussen aanhalingstekens. De aanhalingstekens horen niet bij de signature/handtekening.

=== Een geïnstalleerde app via de commandline gebruiken ===

Je kan de verschillende apps ook via de commandline aanroepen. Bijvoorbeeld om extra features te gebruiken die (nog) niet in de GUI zitten. Het werkt iets anders dan normaal, omdat ze geïnstalleerd zijn in docker containers. 

Lijst met geïnstalleerde apps / docker containers

<code>docker container ls</code>

In de lijst kan je kijken hoe de docker container van de app die je wilt gebruiken heet. Lightning Terminal heeft lightning-terminal_web_1 bijvoorbeeld.

Voer op de volgende manier commando's uit

<code>docker exec -i APPNAAM COMMANDO</code>

Omdat de apps in losse docker containers zitten die je aanroept met het app script, zijn de bestandspaden relatief tot de map van de app in /umbrel/app-data/APPNAAM. Dit geldt ook voor default settings, deze werken vaak niet doordat de apps in docker containers zitten. Houd hier dus rekening mee als je een app via de commandline aanroept. Dit verklaart de extra argumenten in het voorbeeldd.

Een voorbeeld is het recoveren van een pool account van lightning-terminal, mocht je per ongeluk de app hebben verwijderd met nog bitcoin op het account: 

<code>docker exec -i lightning-terminal_web_1 pool --rpcserver localhost:8443 --tlscertpath=~/.lit/tls.cert accounts recover </code>

=== Een minimale kanaalgroote instellen (minchansize) ===
Pas je lnd.conf aan, zet onder '''Application Options''' de instelling '''minchansize=100000''' zodat peers minimaal een kanaal van 100k sat moeten openen. Zie het kopje over [[Umbrel lightning node#Alias (naam) en kleur instellen|het instellen van een alias]] voor informatie hoe je het configuratiebestand aanpast.

=== [[Balance of Satoshis]] (bos) installeren op je Umbrel node ===
[https://github.com/alexbosworth/balanceofsatoshis balanceofsatoshis] is een commandline-tool waarmee je met LND saldo's kan werken, ook kan je deze koppelen aan een eigen Telegram-bot om bijvoorbeeld makkelijk een LN-invoice aan te maken.

# node.js apt repository toevoegen <code>curl -sL <nowiki>https://deb.nodesource.com/setup_16.x</nowiki> | sudo -E bash</code>
# node.js installeren <code>sudo apt-get install -y nodejs</code>
# bos installeren <code>sudo npm install -g balanceofsatoshis</code>
# configuratie aanmaken <code>mkdir -p .bos/umbrel/</code> en <code>nano credentials.json</code>

Bij een normale umbrel-installatie zou de volgende configuratie moeten werken
<pre>
{ "cert_path": "/home/umbrel/umbrel/lnd/tls.cert",
"macaroon_path": "/home/umbrel/umbrel/lnd/data/chain/bitcoin/mainnet/admin.macaroon",
"socket": "localhost:10009" }
</pre>

=== Je compose-file bekijken ===
Log eerst in via SSH, en dan vind je de compose-bestanden per app in:

<code>~/umbrel/app-data/%APPNAME%/docker_compose.yml</code>

== Verdere documentatie ==

=== DarthCoin guides ===
[[DarthCoin guides]] is een serie docs over Umbrel, Lightning en wallets setup, met tips, gotchas en troubleshooting.
Startpunt:
* [https://telegra.ph/Umbrel-Node---Simple-management-guide-03-09 Umbrel BTC/LN Node - Getting started]

Overige documenten van auteur DarthCoin (zie footer in boven genoemd startdocument):
* Umbrel BTC/LN node - Troubleshooting manual
* How to open LN channels with known peers
* Umbrel BTC/LN node + LNDHub + Bluewa
* node + LNbits - Getting started
* How 
* Curated list of places fromin - The 2nd Fire Discovery by wo/man
* Lending in a Bitcoin world

=== NGINX reverse proxy met SSL installeren voor Umbrel/BTCPay Server ===
[[Jorijn Schrijvershof]] heeft een handleiding geschreven waarmee het mogelijk is om [[BTCPayServer|BTCPay Server]] te bereiken buiten TOR om. Dit is natuurlijk reuze handig indien je met jouw webshop gebruik maken van BTCPay Server en zo zijn er nog wel meer toepassingen te bedenken.

* [https://jorijn.com/installing-nginx-reverse-proxy-with-ssl-certificate-umbrel-btcpayserver/ Installing the NGINX reverse proxy with an SSL certificate for Umbrel/BTCPay Server]