Umbrel lightning node
Umbrel is één van de makkelijkste manieren om een Lightning node te beginnen!
Installeren
De podcast Satoshi Radio heeft goeie instructies hoe Umbrel op te zetten. Umbrel is een Bitcoin node en Lightning node in één.
De stappen zijn grofweg:
- Koop #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 nodezaak precies uitgelegd.
- Start de node! Geen kennis van linux nodig.
Acties
Er zijn verschillende acties die je kan doen op/met je Umbrel-node. Hieronder staan er een aantal uitgelegd.
Je node key vinden (Node Key / Lightning Address / URI)
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.
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 PuTTY.
ssh -t umbrel@umbrel.local
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:
ssh -t umbrel@umbrel.local
Voer het wachtwoord in (zelfde als inlogwachtwoord van de webpagina), je zal niet zien dat je het wachtwoord aan het invoeren bent,
Status opvragen van LND
Log in via SSH en doe daarna:
~/umbrel/bin/lncli getinfo
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 zul je alias opnieuw moeten invoeren.
- Log in op je node via SSH
- Open het config bestand: 'sudo nano umbrel/lnd/lnd.conf (dat is LND klein geschreven, niet iND). Hij zal je weer om je wachtwoord vragen (hetzelfde als eerder), en je zult weer niet zien dat je het wachtwoord invoert.
- 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. 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 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
~/umbrel/bin/lncli describegraph | grep channel_id | wc -l
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 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 [1]
- 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" [2]. 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 geinstalleerd 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
cd /INSTALLATIEMAP/UMBREL
bijvoorbeeld cd /home/gebruiker/umbrel
sudo ./scripts/stop
Kopieer de mappen "blocks" en "chainstate" naar een nieuwe locatie
cp -r /ORIGINEEL/umbrel/bitcoin/blocks /NIEUW/umbrel/blocks
cp -r /ORIGINEEL/umbrel/bitcoin/chainstate /NIEUW/umbrel/chainstate
Bijvoorbeeld
cp -r /home/gebruiker/umbrel/bitcoin/blocks /mnt/harddisk/umbrel/blocks
Controleer of er geen verschil is tussen de nieuwe en oude mappen. Bij geen antwoord is er geen verschil.
diff -qr /ORIGINEEL/umbrel/bitcoin/blocks /NIEUW/umbrel/blocks
diff -qr /ORIGINEEL/umbrel/bitcoin/chainstate /NIEUW/umbrel/chainstate
Verwijder de originele mappen als je hebt bevestigd dat de nieuwe map niet verschillend is
rm -r /ORIGINEEL/umbrel/bitcoin/blocks
rm -r /ORIGINEEL/umbrel/bitcoin/chainstate
Verwijs naar de nieuwe plek op de originele locatie met een sybolische of softlink
ls -s /NIEUW/umbrel/blocks /ORIGINEEL/umbrel/bitcoin/blocks
ls -s /NIEUW/umbrel/chainstate /ORIGINEEL/umbrel/bitcoin/chainstate
Controleer of de symbolische link goed gelukt is. Het komt er in een andere kleur te staan, met het symbool ->
ls -la /ORIGINEEL/umbrel/bitcoin
Reboot en ejoy the free disk space!
sudo reboot
Een handmatige update doen
Als je Umbrel blijft hangen, dan kan je een handmatige update doen.
Log in via SSH (zie hierboven) en doe:
cd ~/umbrel && sudo scripts/update/update --repo getumbrel/umbrel
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 ~/umbrel/bin/bitcoin-cli
Een bericht tekenen
Dit kan via de RTL-app, of op de commandline (via SSH):
Log in via SSH (zie boven) en doe:
~/umbrel/bin/lncli signmessage HETBERICHT
Je krijgt dan je signature terug, hij staat tussen aanhalingstekens. De aanhalingstekens horen niet bij de signature/handtekening.