LNbits verbindet Lightning-Backends mit getrennten Wallets, APIs und Erweiterungen. Ein Leitfaden zu Architektur, Einsatzbereichen, Self-Hosting und Sicherheit.
Roland Schellhorn
LNbits ist eine freie, selbst betreibbare Plattform für Anwendungen auf dem Bitcoin Lightning Network. Sie sitzt zwischen einer sogenannten Funding Source – etwa einem eigenen Lightning-Node oder einem unterstützten Wallet-Backend – und den Anwendungen, die Zahlungen senden, empfangen oder verwalten. Dadurch müssen Websites, Apps, Automaten oder Händlerlösungen nicht direkt auf den vollständigen Node-Zugriff zugreifen.
Die offizielle LNbits-Projektbeschreibung nennt dafür drei zentrale Bausteine: getrennte Wallets, eigene API-Schlüssel pro Wallet und ein Erweiterungssystem. LNbits ist dabei kein Ersatz für Bitcoin oder das Lightning Network. Es ist eine Anwendungs- und Kontoschicht über einer vorhandenen Funding Source.
Technisch ist LNbits ein schlanker Python-Server mit Weboberfläche und HTTP-API. Eine Instanz kann mehrere Benutzer und mehrere logisch getrennte Wallets verwalten. Jede Wallet erhält eigene Schlüssel für lesenden oder administrativen API-Zugriff. Anwendungen können dadurch nur mit dem für sie vorgesehenen Konto arbeiten, anstatt Zugang zur gesamten darunterliegenden Liquidität zu erhalten.
Diese Trennung ist besonders nützlich, wenn eine gemeinsame Lightning-Infrastruktur mehrere Projekte versorgt: einen Onlineshop, ein Point-of-Sale-Terminal, eine Spenden-Seite, einen Workshop oder einen internen Prototyp. Die Konten lassen sich getrennt auswerten und bei Bedarf unabhängig ersetzen.
Eine typische Architektur besteht aus drei Ebenen:
LNbits unterstützt verschiedene Backends. Laut der offiziellen Übersicht der Backend Wallets wird die Funding Source über die Konfiguration ausgewählt. Ein Backendwechsel kann erfolgen, ohne Anwendungen, Endpunkte und Erweiterungen grundsätzlich neu aufzubauen. Ob ein Wechsel im konkreten Betrieb reibungslos möglich ist, hängt dennoch von Datenbestand, Versionen, Liquidität und dem gewählten Backend ab.
Eine LNbits-Wallet ist ein abgegrenztes Konto innerhalb der Instanz. Für jede Wallet existieren getrennte API-Schlüssel mit unterschiedlichen Rechten. Das reduziert den Zugriffsumfang einer einzelnen Anwendung. Kompromittierte Zugangsdaten bleiben trotzdem ein Sicherheitsvorfall: Schlüssel müssen wie Secrets gespeichert, regelmäßig überprüft und bei Verdacht ersetzt werden.
Über die API lassen sich unter anderem Rechnungen erstellen, Zahlungen abfragen und Transaktionen verarbeiten. Dadurch kann LNbits als gemeinsame Zahlungsschicht für Webanwendungen, mobile Apps, Geräte oder Automatisierungen dienen. Webhooks und Erweiterungen ergänzen ereignisbasierte Abläufe.
Funktionen außerhalb des Kerns werden als Extensions installiert. Das hält die Basis schlanker und erlaubt eine auf den Anwendungsfall zugeschnittene Instanz. Die LNbits-Dokumentation zur Installation von Extensions warnt ausdrücklich davor, beliebige Quellen zu verwenden: Erweiterungen können Fehler oder schädlichen Code enthalten. Administratoren sollten nur vertrauenswürdige Repositories konfigurieren, Versionen prüfen und Updates zunächst testen.
Mit passenden Erweiterungen lassen sich LNURL-basierte Bezahl- und Auszahlungsabläufe, Point-of-Sale-Anwendungen, Gutscheine oder andere Lightning-Dienste umsetzen. Welche Funktion produktionsreif und für einen konkreten Einsatz geeignet ist, hängt von Extension, Version und Betriebsmodell ab.
Die offizielle Installationsanleitung beschreibt unter anderem AppImage, UV, ein Installationsskript, Nix und Docker. SQLite ist der Standard; für höhere Last verweist die Dokumentation auf PostgreSQL. Bei Docker müssen Daten und Erweiterungen über persistente Volumes gesichert werden, da sie sonst beim Ersetzen eines Containers verloren gehen können.
Für produktive Installationen gehören Reverse Proxy, TLS, Datenbank-Backups, persistenter Storage, Monitoring und ein kontrollierter Updateprozess zur Grundarchitektur. Erweiterungen sollten gemeinsam mit dem Core getestet und aktualisiert werden. Die Dokumentation empfiehlt außerdem, den SuperUser nur für die Ersteinrichtung und kritische Instanzkonfiguration zu verwenden; Alltag und Wartung sollten über getrennte Admin- oder Benutzerkonten erfolgen.
LNbits kann Zugriffe aufteilen, hebt aber das Verwahrungs- und Betriebsrisiko nicht auf. Wer eine Instanz für andere Personen oder Unternehmen betreibt, übernimmt Verantwortung für Verfügbarkeit, Zugangskontrolle, Backups, Updates und die darunterliegende Funding Source. Je nach Geschäftsmodell und Rechtsraum können zusätzlich regulatorische oder steuerliche Pflichten entstehen.
Wichtige Maßnahmen sind:
LNbits eignet sich besonders als flexible Wallet-, API- und Extension-Schicht. BTCPay Server legt einen stärkeren Schwerpunkt auf vollständige Händler- und Checkout-Prozesse. Eine direkte Node-Integration bietet maximale Kontrolle, verlangt aber mehr eigene Entwicklung und Sicherheitsarbeit.
Die richtige Wahl hängt nicht allein von einer Funktionsliste ab. Entscheidend sind Verwahrungsmodell, Nutzerzahl, Zahlungsvolumen, benötigte Erweiterungen, Teamkompetenz und Betriebsverantwortung. Für manche Systeme ist auch eine Kombination sinnvoll: eine spezialisierte Checkout-Lösung für den Shop und LNbits für interne Wallets, Prototypen oder zusätzliche Lightning-Dienste.
LNbits ist interessant, wenn mehrere Lightning-Anwendungen eine gemeinsame technische Basis benötigen, Wallets voneinander getrennt werden sollen oder ein schneller API-basierter Prototyp entstehen soll. Für ein einzelnes, sehr einfaches Zahlungsziel kann eine schlankere Lösung genügen. Für regulierte Verwahrung, hohe Beträge oder geschäftskritische Zahlungsinfrastruktur braucht es zusätzlich ein belastbares Sicherheits-, Compliance- und Betriebskonzept.
BIT62 unterstützt bei Architektur, Self-Hosting, Lightning-Backend-Anbindung, API-Integration, individuellen Erweiterungen sowie beim sicheren Betrieb mit Backups und Monitoring. Der sinnvolle Ausgangspunkt ist eine klare Trennung zwischen Funding Source, LNbits-Instanz und angebundenen Anwendungen.
Wenn du LNbits für einen Shop, eine App, einen Automaten oder eine interne Lightning-Infrastruktur evaluierst, können wir Anforderungen, Risiken und Betriebsmodell gemeinsam prüfen.
Eigene Konten und API-Schlüssel begrenzen den Zugriff einzelner Anwendungen.
Lightning-Zahlungen in Websites, Apps, Geräte und Automatisierungen integrieren.
Eine schlanke Basis gezielt um LNURL-, Händler- und Spezialfunktionen ergänzen.
Rechnungen, Point of Sale und Zahlungsbestätigungen in eigene Abläufe einbinden.
Unterstützte Lightning-Backends über eine stabile Anwendungsschicht abstrahieren.
Persistenz, Backups, Monitoring, Rollen und Updates professionell planen.
BIT62 unterstützt dich bei Self-Hosting, Funding-Source-Anbindung, API-Integration, Erweiterungen, Backups, Monitoring und sicherem Betrieb.