| Huidige versie |
Je tekst |
| Regel 19: |
Regel 19: |
| |Een lokale blokexplorer die de data gebruikt van je node | | |Een lokale blokexplorer die de data gebruikt van je node |
| |- | | |- |
| |BTC RPC Explorer | | |[[BTC RPC Explorer]] |
| |Een lokale [[Links#Block explorers|blokexplorer]] die de data gebruikt van je node | | |Een lokale blokexplorer die de data gebruikt van je node |
| |- | | |- |
| |[[Samourai|Samourai Server]] | | |[[Samourai|Samourai Server]] |
| Regel 31: |
Regel 31: |
| |Een applicatie die het mogelijk maakt om te chatten via het lightning netwerk en streaming payments implemeteert voor podcasts. | | |Een applicatie die het mogelijk maakt om te chatten via het lightning netwerk en streaming payments implemeteert voor podcasts. |
| |- | | |- |
| |[[RTL|Ride the Lightning]] | | |[[Ride the Lightning]] |
| |Een grafische interface om je lightning node te beheren. | | |Een grafische interface om je lightning node te beheren. |
| |- | | |- |
| Regel 43: |
Regel 43: |
| |Een open-source lightning wallet die het mogelijk maakt om meerdere lightningwallets te gebruiken op één node. | | |Een open-source lightning wallet die het mogelijk maakt om meerdere lightningwallets te gebruiken op één node. |
| |- | | |- |
| |[[BTCPayServer|BTCPay Server]] | | |[[BTCPay Server]] |
| |Een paymentprocesor die het mogelijk maakt om Bitcoin en Lightning te accepteren zonder tussenkomst van een 3e partij. | | |Een paymentprocesor die het mogelijk maakt om Bitcoin en Lightning te accepteren zonder tussenkomst van een 3e partij. |
| |} | | |} |
| == Acties == | | == Acties == |
| Er zijn verschillende acties die je kan doen met je Umbrel node. Hieronder staan er een aantal uitgelegd. | | 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) === | | === Je node key vinden (Node Key / Lightning Address / URI) === |
| Regel 54: |
Regel 54: |
|
| |
|
| In het Lightningscherm van Umbrel moet je op de 3 puntjes klikken (zie ook het plaatje) om je Lightning Address te vinden. | | 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.
| |
|
| |
| Je kan je wallet als volgt aan Zeus koppelen:
| |
|
| |
| * Ga naar Umbrel home-scherm
| |
| *Kies "Lightning Node"
| |
| *Kies "Connect Wallet"
| |
| * Open Zeus op je telefoon
| |
| * Kies "Scan lndconnect config"
| |
| * Scan de QR-code weergeven in je Umbrel interface (of voor alles handmatig in)
| |
| * Vink "Use Tor" en "Certificate Verification" beide aan (de laatste is niet noodzakelijk, maar een extra beveiliging)
| |
| *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 === | | === Inloggen via SSH === |
| Regel 112: |
Regel 74: |
|
| |
|
| # Log in op je node via SSH | | # Log in op je node via SSH |
| # Open het config bestand: '''nano umbrel/lnd/lnd.conf'' (dat is LND klein geschreven, niet iND). | | # 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. | | # 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]. | | # (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]. |
| Regel 126: |
Regel 88: |
| Log in via SSH en doe daarna | | Log in via SSH en doe daarna |
|
| |
|
| <code>docker exec -i lnd lncli describegraph | grep channel_id | wc -l</code> | | <code>~/umbrel/bin/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. | | 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. |
| Regel 199: |
Regel 161: |
|
| |
|
| === Bitcoin-cli commando's draaien === | | === 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> | | Verbind via SSH (ssh umbrel@umbrel.local) met je Umbrel node. Je kunt je bitcoin-cli commando's uitvoeren met <code>~/umbrel/bin/bitcoin-cli</code> |
|
| |
|
| === LND-cli commando's draaien === | | === 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> | | Verbind via SSH (ssh umbrel@umbrel.local) met je Umbrel node. Je kunt je bitcoin-cli commando's uitvoeren met <code>~/umbrel/bin/lncli</code> |
|
| |
|
| Bijvoorbeeld de status van je node | | Bijvoorbeeld de status van je node |
| <pre>docker exec -i lnd lncli getinfo</pre> | | <pre>~/umbrel/bin/lncli getinfo</pre> |
|
| |
|
| === Een bericht tekenen === | | === Een bericht tekenen === |
| Regel 212: |
Regel 174: |
| Log in via SSH (zie boven) en doe: | | Log in via SSH (zie boven) en doe: |
|
| |
|
| <code>docker exec -i lnd lncli signmessage HETBERICHT</code> | | <code>~/umbrel/bin/lncli signmessage HETBERICHT</code> |
|
| |
|
| Je krijgt dan je signature terug, hij staat tussen aanhalingstekens. De aanhalingstekens horen niet bij de signature/handtekening. | | Je krijgt dan je signature terug, hij staat tussen aanhalingstekens. De aanhalingstekens horen niet bij de signature/handtekening. |
| Regel 222: |
Regel 184: |
| Lijst met geïnstalleerde apps / docker containers | | Lijst met geïnstalleerde apps / docker containers |
|
| |
|
| <code>docker container ls</code> | | <code>~/umbrel/scripts/app ls-installed</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 | | Voer op de volgende manier commando's uit |
|
| |
|
| <code>docker exec -i APPNAAM COMMANDO</code> | | <code>~/umbrel/scripts/app compose APPNAAM exec 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]
| | Let op: sommige apps hebben de toevoeging web nodig na exec. |
