Alby: Dein Bitcoin-Lightning-Wallet im Webbrowser

Alby wurde entwickelt, um ein Bitcoin-Lightning-Wallet direkt im Webbrowser bereitzustellen. Mit nur einem Klick kannst du während des Surfens Zahlungen tätigen. Dazu wurde eine Erweiterung für Internetbrowser geschaffen, die mehrere Wallets verwalten kann. Diese Wallets können unterschiedliche Finanzierungsquellen nutzen, z. B. einen Lightning-Node, ein Phoenix Wallet, LNbits oder andere Lightning-Wallet-Lösungen.

Lange Zeit bot Alby auch einen Custody-Lightning-Wallet-Server an, der insbesondere Einsteigern den Einstieg erleichterte. Von Beginn an hat Alby jedoch die Möglichkeit geschaffen, dass Nutzer ihre eigenen Lightning-Wallets mit Alby verbinden können. Dadurch können sie die vielfältigen Funktionen der Plattform nutzen, ohne auf zentrale Verwahrung angewiesen zu sein.

Ein Custody-Server, der Finanzdienstleistungen in Europa anbietet, ist aktuell mit enormen regulatorischen Auflagen, hohen Kosten und Risiken verbunden. Deshalb arbeiten Entwickler weltweit daran, Lösungen zu schaffen, die es Nutzern ermöglichen, ihre Satoshis selbst zu verwahren. Alternativ könnten sich kleine private Gemeinschaften bilden, die diese Aufgabe gemeinsam übernehmen.

Ein Beispiel: Du könntest eine Plattform für deine Familie und Freunde bereitstellen, die grundlegende Finanzdienstleistungen auf Basis von Bitcoin und Lightning ermöglicht. Dabei handelt es sich um Anwendungen für den täglichen Bedarf, wie das Bezahlen eines Biers, das Lesen eines Artikels, das Spenden oder Boosten in Podcasts. Die Verwaltung großer Summen bleibt ohnehin im Cold Storage – Alby bietet die Flexibilität für die alltäglichen, schnellen Transaktionen.

1. Was ist den jetzt AlbyHub

Gute Frage und eine die

2. Alby Konten, Accounts, Erweiterungen und AlbyHub

Kurze Begriffserklärung:

Alby Account: Ein (Web-)Account, den man sich bei getalby.com anlegen kann. Man benötigt eine gültige Email Adresse und hat ein Passwort für den Account. Den Account muss man mit einem Lightning Wallet verknüpfen. Der Account kann eine Lightning Adresse bereitstellen im Format name@getalby.com. Dadurch ist das Lightning Wallet mit der Lightning Adresse verknüpft.

Alby Browser Erweiterung: Die ist eine Erweiterung für Browser die mehrere Konten haben kann. Ein Konto kann z.B. mit einem Alby Account verknüpft werden. Es gibt aber noch mehr Optionen um Konten in der Browser Erweiterung zu erstellen, z.B. das verbinden mit einem LNbits Wallet oder seinem eigenen Node oder eine AlbyHub Account. Jedes Alby Browser Erweiterungskonto hat eine Wiederherstellungsphrase (Hauptschlüsse/Seed) und eine Nostr Identität.

2.1 Alby Web-Konto (Account) anlegen und einrichten

2.1.1 Gehe auf getalby.com und wähle „Create Account“.
2.1.2 Wähle einen Alby Account Name und gib eine E-Mail-Adresse an. Löse dann den CAPTCHA-Test und klicke auf „Sign up“. Jetzt hast du ein Alby-Web-Konto (Account).
2.1.3 Klicke oben rechts auf deinen Alby Account Name > Settings > Alby Account. Hier kannst du ein Avatar-Bild hinzufügen oder den Account-Namen ändern.
2.1.4 Klicke dann auf „Password > Start password reset…“.
2.1.5 Öffne dein E-Mail-Programm, suche die E-Mail von Alby, klicke auf den Link „Reset password“ und lege ein sicheres Passwort fest.
2.1.6 Logge dich mit deiner E-Mail-Adresse und deinem Passwort ein.
2.1.7 Klicke oben rechts auf Alby Account Name > Settings > Lightning Address, lege dir eine @getalby.com Lightning-Adresse an und klicke auf „Update your lightning address“.

2.2 Alby Browser Erweiterung hinzufügen

2.2.1 In deinem Alby Account wähle „Connect > Alby Browser Extension > Install Extension“ und füge die Erweiterung hinzu. Hinweis: Der Vorgang ist browserabhängig.
2.2.2 Lege einen Unlock Passcode fest, um die Erweiterung zu entsperren. Achtung: Mit dem Passcode werden lokal die Daten der Browser Erweiterung verschlüsselt. Der Passcode gilt nur hier und nur für diesen einen Browser.
2.2.3 Verbinde die Erweiterung mit deinem Alby Account, indem du auf „Weiter mit Alby Account“ klickst.
2.2.4 Pinne die Erweiterung oben rechts im Browser an, indem du der Anleitung unter „Beginne mit Alby 🐝“ folgst.

2.3 Die Alby Erweiterung einrichten

2.3.1 Klicke oben rechts auf das Alby-Icon. Es öffnet sich ein kleines Fenster für die Erweiterung.
2.3.2 Wähle links das „Hamburger-Symbol 🍔 > Vollbild“, um die Webansicht der Erweiterung im Browser zu öffnen.
2.3.3 Klicke oben rechts auf deine Email Adresse (oder Alby Account Name), dann öffnet sich darunter eine Liste und klick dann rechts neben das Globus-Symbol auf Wallet-Einstellungen.
2.3.4 Gib einen Anzeigenamen ein (z. B. deinen Alby Account Name) und speichere die Änderungen.
2.3.5 Unter „Schlüsselverwaltung > Phrase anzeigen“ findest du deinen Hauptschlüssel in Form eines 12-Wörter-Seeds. Sichere sie dir gut weg, denn davon wird deine Nostr-Identität abgeleitet. Mit ihm kannst du später Schlüssel für deine Nostr-ID, Bitcoin- oder Liquid-Wallets sowie Lightning-Authentifizierungen wiederherstellen.
2.3.6 Hast du dir den 12-Wörter Seed auch wirklich gut weggespeichert? Falls nicht, dann spring nochmal zu Punkt 2.3.5, denn das ist wirklich sehr, sehr wichtig!
2.3.7 Wenn du noch keine Nostr-ID mit Schlüsselpaar besitzt, kannst du den vorgeschlagenen Schlüssel verwenden. Unter „Schlüsselverwaltung > Nostr öffentlicher Schlüssel“ findest du den „npub..“ und unter „Nostr Einstellungen“ den privaten Schlüssel „nsec..“. Den öffentlichen kannst du mit Anderen teilen. Den privaten Schlüssel solltest du sehr vorsichtig verwenden. Das ist der Zugriffschlüssel für eure Nostr Identität, die ihr nicht verlieren wollt.

Info: Der öffentliche Schlüssel (npub) leitet sich vom privaten Schlüssel (nsec) ab. Und der private Schlüssel leitet sich vom Hauptschlüssel (der 12-Wörter Seed) ab. Daher ist der 12-Wörter Seed so wichtig. Mit dem könnte ihr eure Identität wieder herstellen.

Hinweis: Wenn du bereits ein Nostr-Schlüsselpaar besitzt, kannst du den vorgeschlagenen privaten Schlüssel entfernen und deinen eigenen hinzufügen. Beachte jedoch, dass das Ableiten des Schlüsselpaares vom Hauptschlüssel (Seed) dann nicht mehr funktioniert. Das Bitcoin-/Liquid-Wallet und die Lightning-Authentifizierungen bleiben aber weiterhin vom Hauptschlüssel abgeleitet, nur eben nicht der Nostr Teil.

Wichtig Information: Der Hauptschlüssel (Seed) ist nicht mit deinem Alby Account verknüpft! Installierst du die Erweiterung neu, oder auf einem anderen Browser, erhältst du einen neuen Hauptschlüssel. Möchtest du deine bestehendes Wallet und Nostr Identität mit der Erweiterung verknüpfen, dann musst du den Hauptschlüssel (Seed) oder den privaten Nostr Schlüssel dort eintragen.

2.4 Erweiterte Einstellungen der Erweiterung

2.4.1 In der Webansicht der Erweiterung klicke links auf das „Hamburger-Symbol 🍔 > Einstellungen der Erweiterung“.
2.4.2 Hier kannst du ggf. den Unlock Passcode für die Erweiterung ändern. Beachte, dass der Passcode nur für diesen Browser/diese Erweiterung gilt und kein Account-übergreifendes Passwort ist. Er wird lediglich zum Entsperren dieser einen Erweiterung genutzt.
2.4.3 Unter „Persönliche Daten > Name / Email“ kannst du beliebige Daten eingeben. Diese haben nichts mit dem Namen oder der E-Mail-Adresse deines Accounts zu tun.

2.5 Verwalten des Web-Kontos (Accounts)

2.5.1 In der Webansicht der Erweiterung wähle oben rechts deinen Alby Account Name und klicke auf das Geo-Erde-Symbol 🌐 daneben.
2.5.2 Jetzt befindest du dich wieder im Web-Konto und nicht mehr in der Erweiterung. Beide sind über die E-Mail-Adresse des Accounts miteinander verknüpft.
2.5.3 Wähle oben rechts „Alby Account Name > Wallet Configuration“ und klicke dann auf „Link to Your Own Wallet“, um die Optionen zu sehen.
2.5.4 Falls du von Freunden einen Nostr Wallet Connect (NWC)-Link erhalten hast, wähle „Link Manually > Nostr Wallet Connect“, füge den „nostr+walletconnect://…“-Link ein und klicke auf „Link to Wallet“.
2.5.5 Damit ist dein Alby Account jetzt mit einem Wallet (Finanzierungsquelle) über den Alby-Hub verbunden. 🎉
2.5.6 Du kannst das Wallet jetzt wie gewohnt zum Senden und Empfangen nutzen. Beachte, dass die Aktualisierung im Web-Konto etwas träge sein kann, da sie über den Alby-Server läuft. Hab Geduld und aktualisiere die Seite bei Bedarf mit F5.

3. AlbyHub installieren

Vorbereitung – Domain einrichten: Richte eine Domain oder Subdomain ein, die auf deinen VPS verweist. Wenn du z. B. die AlbyHub-Webseite über albyhub.yourwebsite.xyz erreichen möchtest, müssen der A- und AAAA-Eintrag auf die IP-Adresse deines VPS zeigen.

Hinweis: Falls dein VPS neben einer IPv4-Adresse auch eine IPv6-Adresse besitzt, muss diese ebenfalls über den AAAA-Eintrag verknüpft werden. Andernfalls kann es zu Verbindungsproblemen kommen.

3.1 Voraussetzungen auf dem VPS installieren

sudo apt-get install bzip2

3.2 AlbyHub mit dem Installationsskript installieren

Führe das Installationsskript für AlbyHub aus:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/getAlby/hub/master/scripts/linux-x86_64/install.sh)"

Während der Installation wirst du durch die Konfiguration geführt:

1. Drücke ENTER, um das Standardverzeichnis /home/blitzbank/albyhub zu verwenden
2. „Do you want to setup a systemd service (requires sudo permission)? (y/n):“ Drücke y und dann ENTER, um den Service einzurichten.
3. ✅ DONE. Open Alby Hub to get started -> Alby Hub runs by default on localhost:8029

albyhub.service Status und Server Logs prüfen:

sudo systemctl status albyhub
sudo journalctl -u albyhub -f --since "2 hour ago"

Nützliche Befehle:

sudo systemctl stop albyhub
sudo systemctl start albyhub
sudo systemctl status albyhub
sudo systemctl disable albyhub
sudo systemctl enable albyhub
sudo systemctl daemon-reload
sudo systemctl restart albyhub

Original Dokumentation, siehe GitHub.

3.3 AlbyHub updaten

Ein Update durchführen ist recht einfach:

cd ~/albyhub
./update.sh

-> y + ENTER und nochmal ENTER

4. Caddyfile einrichten

Caddyfile öffnen:

sudo nano /etc/caddy/Caddyfile

Caddyfile erweitern mit:

# AlbyHub
albyhub.yourdomain.xyz {
        reverse_proxy 127.0.0.1:8029
}

Caddy reloaden:

sudo systemctl reload caddy

Hier noch zwei nützliche Befehle, um den Status und die Logs des Caddy Server zu prüfen:

sudo systemctl status caddy
sudo journalctl -u caddy -f --since "2 hour ago"

5. AlbyHub automatisch entsperren

AlbyHub ist nach einem Neustart standardmäßig gesperrt. Ihr könnt den AlbyHub automatisch entsperren lassen.

5.1 Konfigurationsdatei .env erstellen

Exampel .env herunterladen und zu .env kopieren:

wget https://raw.githubusercontent.com/getAlby/hub/refs/heads/master/.env.example -P ~/albyhub
cp ~/albyhub/.env.example ~/albyhub/.env

.env öffnen und editieren:

nano ~/albyhub/.env

Die geöffnete .env Datei damit füllen, die Zeile mit dem Unlock Password aktivieren (-> „#“ löschen) und das Passwort für den AlbyHub Login einfügen:

AUTO_UNLOCK_PASSWORD=YourAlbyHubUnlockPassword

5.2 Die .env Datei dem System bekannt machen

Die Datei mit dem Umgebungsvariablen im albyhub.service eintragen:

sudo nano /etc/systemd/system/albyhub.service

Am Ende von [Service]:

EnvironmentFile=/home/blitzbank/albyhub/.env

Neu laden:

sudo systemctl daemon-reload
sudo systemctl restart albyhub
sudo systemctl status albyhub

Hinweis: Stellt sicher, dass im Web-Browser euren Alby User eingeloggt ist, den ihr für AlbyHub verwenden möchtet. Das Alby Wallet in der Erweiterung reicht nicht, der Alby User muss im Web-Browser eingeloggt sein.

Phoenix API-Key anzeigen lassen

cat ~/.phoenix/phoenix.conf ; echo