Verbinde die BitBoxApp mit deiner eigenen Bitcoin-Full-Node, um Kontostände und Transaktionsverläufe über deine eigene Infrastruktur abzurufen und signierte Bitcoin-Transaktionen an das Netzwerk zu übermitteln. Die App greift dafür auf einen Electrum-kompatiblen Server zu, der die Blockchain-Daten deiner Node bereitstellt. Sie verbindet sich also nicht direkt mit Bitcoin Core.

Das funktioniert mit einem Computer oder Smartphone und über ein VPN auch außerhalb deines Heimnetzwerks. Wenn du deinen Server hinzufügst, bleiben die bisherigen Server als Alternativen verfügbar. Soll die BitBoxApp ausschließlich deine eigene Bitcoin-Infrastruktur nutzen, musst du diese Alternativen ebenfalls entfernen und die App neu starten.

Bevor du beginnst

Du brauchst die aktuelle BitBoxApp und eine vollständig synchronisierte Bitcoin-Node. Auch der Electrum-kompatible Server muss die Synchronisierung und Indexierung abgeschlossen haben. Node-Pakete wie Umbrel, Start9 oder RaspiBlitz können einen solchen Server bereitstellen. Die Dokumentation deines Pakets erklärt, wie du ihn einrichtest und seine Verbindungsdaten findest.

Wenn du deine Node selbst verwaltest, sind electrs und ElectrumX mögliche Electrum-Server. Welche Bitcoin-Core-Version damit zusammenarbeitet, hängt von der jeweiligen Backend-Version ab. Beachte die Dokumentation der Version, die du installierst, insbesondere die Anforderungen an Speicherplatz und Indizes.

Ob Pruning möglich ist, hängt vom Electrum-Server ab. Dafür gibt es keine gesonderte Pruning-Einstellung in der BitBoxApp. Sowohl electrs als auch ElectrumX benötigen eine Bitcoin-Core-Node ohne Pruning. Möchtest du ein anderes Backend mit Pruning nutzen, prüfe, ob es die historischen Daten und Electrum-Funktionen bereitstellen kann, die die BitBoxApp benötigt.

Auch bei disablewallet=1 kommt es auf das Backend an: Du kannst die Wallet-Funktion von Bitcoin Core nur deaktivieren, wenn dein Backend sie nicht benötigt. Diese Einstellung macht ein Backend nicht mit Pruning kompatibel.

Besorge dir vor dem nächsten Schritt den Electrum-Endpunkt deines Servers: einen Hostnamen oder eine IP-Adresse mit Port, etwa hostname:port. Verwende den Endpunkt und den Verbindungstyp aus deiner Node-Software, nicht die RPC-Adresse von Bitcoin Core. Ersetze den angegebenen Port nicht durch 50001 oder 50002, sofern die Anleitung deiner Node das nicht ausdrücklich vorsieht.

Wähle den Verbindungsweg zu deiner Node

Wähle eine Verbindung, die deine Node bereitstellt, und bereite sie vor, bevor du den Endpunkt in der BitBoxApp hinzufügst.

Für einen Onion-Endpunkt auf dem Computer musst du zuerst den Tor-Proxy der BitBoxApp einrichten. Der Onion-Endpunkt muss zum Electrum-Server führen, nicht nur zur Verwaltungsoberfläche deiner Node. Lass Tor laufen, solange du diesen Endpunkt nutzt. Unter iOS ist die Tor-Proxy-Option der BitBoxApp nicht verfügbar; nutze dort eine lokale Verbindung oder ein VPN.

Für eine direkte lokale Verbindung oder eine VPN-Verbindung deaktiviere unter Einstellungen → Erweiterte Einstellungen die Option Tor Proxy aktivieren, falls sie eingeschaltet ist. Schließe die BitBoxApp anschließend vollständig und öffne sie erneut, damit sie sich direkt verbindet.

Gib deinen Electrum-Server nicht durch eine Portweiterleitung im Router für das öffentliche Internet frei. Nutze für den Zugriff dein lokales Netzwerk, ein VPN oder den Onion-Endpunkt deiner Node.

Nutze deine Node unterwegs über ein VPN

Mit einem VPN kann deine Node auch dann erreichbar sein, wenn dein Smartphone mobile Daten nutzt oder dein Computer mit einem anderen Netzwerk verbunden ist. Eine Möglichkeit ist Tailscale: Es verbindet deine Geräte über ein privates, verschlüsseltes Netzwerk. Deine Node benötigt weiterhin einen synchronisierten Electrum-Server.

1. Installiere Tailscale auf dem Rechner, auf dem deine Node läuft, und füge ihn deinem Tailscale-Netzwerk hinzu. Auf Umbrel kannst du dafür die Tailscale-App aus dem Umbrel App Store installieren. Schließe die Einrichtung anhand der Anleitung deiner Node-Software ab.
2. Installiere Tailscale auf dem Smartphone oder Computer, auf dem du die BitBoxApp nutzt, und verbinde es mit demselben Tailscale-Netzwerk. Für eine einfache private Einrichtung kannst du auf beiden Geräten dasselbe Konto verwenden. Folge der Tailscale-Einrichtungsanleitung und erteile die dort erforderlichen Gerätefreigaben und VPN-Berechtigungen.
3. Ermittle in Tailscale die Tailscale-IP-Adresse des Rechners, auf dem deine Node läuft. Verwende diese Adresse zusammen mit dem Electrum-Port, den deine Node-Software angibt. Der Electrum-Dienst muss unter dieser Adresse und diesem Port erreichbar sein. Dass du die Verwaltungsoberfläche der Node öffnen kannst, bestätigt noch keinen Electrum-Zugriff.

Lass Tailscale verbunden und folge mit diesem Endpunkt dem nächsten Abschnitt Electrum-Server hinzufügen. Richte danach die ausschließliche Nutzung deiner Node ein und prüfe den Zugriff von unterwegs. Tailscale ist ein Netzwerkdienst eines Drittanbieters; der Zugriff setzt voraus, dass deine Geräte weiterhin autorisiert und verbunden sind.

Füge deinen Electrum-Server hinzu

Sobald Node und Electrum-Server bereit und über den gewählten Verbindungsweg erreichbar sind, kannst du den Endpunkt hinzufügen. Dafür brauchst du keine Wiederherstellungswörter, privaten Schlüssel oder Wallet-Backups einzugeben.

1. Öffne in der BitBoxApp die Einstellungen. Auf dem Smartphone findest du sie in der unteren Navigationsleiste. Wähle Erweiterte Einstellungen → Eigenen Full Node verbinden und gegebenenfalls Bitcoin Electrum Server.
2. Trage unter Server hinzufügen den vollständigen Electrum-Endpunkt in das Feld host:port ein.

Verwendet der Endpunkt TLS, füge das Serverzertifikat in das Zertifikatsfeld ein, einschließlich der Zeilen -----BEGIN CERTIFICATE----- und -----END CERTIFICATE-----. Beziehe es über einen vertrauenswürdigen Zugriff auf deine eigene Node. Alternativ kannst du Remote-Zertifikat herunterladen wählen und das heruntergeladene Zertifikat mit dem Zertifikat vergleichen, das du über diesen vertrauenswürdigen Zugriff von deiner Node erhalten hast. Brich ab, wenn die Zertifikate voneinander abweichen oder du nicht feststellen kannst, ob das Zertifikat zu deiner Node gehört.

Bei einem Endpunkt ohne TLS bleibt das Zertifikatsfeld leer. Verwende nur den Verbindungstyp, den deine Node bereitstellt.

1. Wähle Überprüfen und warte auf die Meldung Verbindung zu [deinem Endpunkt] wurde erfolgreich hergestellt. Schließe die Meldung. Schlägt die Prüfung fehl, behebe den Fehler, bevor du fortfährst.
2. Wähle Hinzufügen. Dein Endpunkt erscheint in der Serverliste unter Servers. Schließe die BitBoxApp vollständig und öffne sie erneut, um die geänderte Serverkonfiguration anzuwenden.

Eine erfolgreiche Prüfung bestätigt, dass die App eine Electrum-Verbindung zum Endpunkt herstellen kann. Sie prüft weder sämtliche Wallet-Funktionen noch, ob die App ausschließlich deine Node nutzt.

Nutze ausschließlich deine eigene Node und prüfe das Ergebnis

Solange andere Bitcoin-Server eingetragen sind, kann die BitBoxApp sie als Alternativen nutzen. Entferne alle Server, die du nicht selbst kontrollierst, wenn Bitcoin-Kontoabfragen und Transaktionsübermittlungen ausschließlich über deine Infrastruktur laufen sollen.

1. Öffne erneut Einstellungen → Erweiterte Einstellungen → Eigenen Full Node verbinden → Bitcoin Electrum Server. Suche deinen Endpunkt in der Liste Servers und wähle daneben Überprüfen, um seine Erreichbarkeit zu bestätigen.
2. Wähle neben jedem Standardserver und jedem anderen Bitcoin-Server eines Drittanbieters Entfernen und bestätige die jeweilige Entfernung. Lass deinen eigenen funktionierenden Endpunkt in der Liste.
3. Schließe die BitBoxApp vollständig und öffne sie erneut. Öffne dein Bitcoin-Konto und warte, bis die Synchronisierung abgeschlossen ist. Prüfe, ob sich Kontostand und Transaktionsverlauf ohne Verbindungsfehler aktualisieren. Wenn nur dein eigener Endpunkt eingetragen ist, hängen diese Aktualisierungen von deiner Node ab.
4. Hast du einen VPN-Zugriff eingerichtet, teste ihn von außerhalb deines Heimnetzwerks. Schalte auf dem Smartphone vorübergehend WLAN aus und nutze mobile Daten; verwende auf dem Computer ein anderes Netzwerk. Lass das VPN verbunden, schließe die BitBoxApp und öffne sie erneut. Prüfe, ob sich dein Bitcoin-Konto ohne Verbindungsfehler synchronisiert. Schalte WLAN anschließend wieder ein, falls du es ausgeschaltet hast.

Ist nur dein eigener Endpunkt eingetragen, werden Bitcoin-Transaktionen, die du aus der BitBoxApp sendest, über diesen Electrum-Server und deine Node an das Netzwerk übermittelt – auch bei einer VPN-Verbindung. Mit der Kontosynchronisierung prüfst du den Datenzugriff von unterwegs; die Übermittlung von Transaktionen wird dabei nicht getestet.

Lass die Node, den Electrum-Server und die gegebenenfalls benötigte VPN- oder Tor-Verbindung laufen. Sind sie nicht verfügbar, kann die App deine Bitcoin-Konten nicht aktualisieren und über diesen Endpunkt keine Bitcoin-Transaktionen übermitteln. Die Änderung der Serverkonfiguration selbst bewegt keine bitcoin und verändert die privaten Schlüssel deiner BitBox-Wallet nicht.

Diese Einstellung betrifft das Bitcoin-Backend. Sie leitet nicht jeden Dienst der BitBoxApp über deine Node. Im Artikel Welche Daten gibt die BitBoxApp weiter? findest du die Abgrenzung zu anderen Konten und Diensten.

Verbindungsprobleme beheben

Die Verbindungsprüfung schlägt fehl oder endet mit einer Zeitüberschreitung

• Prüfe, ob Bitcoin Core synchronisiert ist und auch der Electrum-Server die Synchronisierung und Indexierung abgeschlossen hat.
• Prüfe, ob deine Backend-Version die verwendete Bitcoin-Core-Version und Konfiguration unterstützt. Dazu gehören Pruning, erforderliche Indizes und die Frage, ob die Wallet-Funktion von Bitcoin Core aktiviert sein muss.
• Kopiere den Electrum-Endpunkt mit Port erneut aus deiner Node-Software. Ein Bitcoin-Core-RPC-Endpunkt ist kein Electrum-Endpunkt.
• Prüfe die Erreichbarkeit vom Gerät aus, auf dem die BitBoxApp läuft: Verbinde es je nach gewähltem Weg mit dem lokalen Netzwerk oder VPN oder starte den Tor-Proxy auf dem Computer. Die Proxy-Einstellung der BitBoxApp muss zum gewählten Verbindungsweg passen.
• Bei Tailscale müssen beide Geräte mit demselben Tailscale-Netzwerk verbunden und für die gegenseitige Kommunikation autorisiert sein. Prüfe, ob der Electrum-Port über die Tailscale-Adresse deiner Node erreichbar ist. Bei Problemen mit dem Netzwerkzugriff hilft die Tailscale-Anleitung zur Fehlerbehebung bei Geräteverbindungen.

Wird bei der Nutzung von Tor connection refused angezeigt, prüfe, ob der lokale Tor-Proxy läuft und seine Adresse mit der Einstellung in der BitBoxApp übereinstimmt. Folge der Anleitung zur Tor-Einrichtung und Fehlerbehebung.

Das Zertifikat lässt sich nicht herunterladen oder überprüfen

Ein Endpunkt ohne TLS stellt kein TLS-Zertifikat bereit. Gibt deine Node getrennte TCP- und TLS-Endpunkte an, verwende genau den Endpunkt für den gewünschten Verbindungstyp. Prüfe bei einem TLS-Endpunkt das aktuelle Zertifikat über einen vertrauenswürdigen Zugriff auf deine Node. Akzeptiere keinen unerklärten Zertifikatswechsel und wechsle nicht zu einer unverschlüsselten Verbindung, nur um einen Fehler zu umgehen.

Die Verbindungsprüfung ist erfolgreich, aber das Konto aktualisiert sich nicht

Starte die BitBoxApp nach Änderungen an der Serverliste neu und prüfe den Synchronisierungsstand sowie die Logs des Electrum-Servers. Das Backend muss die von der App benötigten Wallet-Funktionen unterstützen: Abfragen und Abonnements von Adressverläufen, den Abruf von Transaktionen, Block-Header und Transaktionsnachweise, Gebühreninformationen sowie die Übermittlung von Transaktionen an das Netzwerk. Eine funktionierende TLS-Verbindung oder eine Watch-only-Funktion allein bestätigt diese Kompatibilität nicht.

Besteht das Problem weiterhin, kontaktiere den BitBox Support. Nenne die Versionen der BitBoxApp, von Bitcoin Core und des Backends, den Status von Pruning und der Wallet-Funktion in Bitcoin Core, deinen Verbindungsweg und die genaue Fehlermeldung. Entferne Zugangsdaten, private Endpunktangaben und nicht benötigte persönliche Informationen aus Screenshots oder Log-Auszügen. Teile niemals Wiederherstellungswörter, private Schlüssel, Passwörter, Passphrasen oder Wallet-Backups.

Deine Node ist nicht verfügbar

Stelle zunächst die Funktion der Node, des Backends und der benötigten Netzwerkverbindung wieder her. Wenn du vorübergehend zu den Bitcoin-Standardservern zurückkehren möchtest, öffne Bitcoin Electrum Server, wähle In Werkszustand zurücksetzen und bestätige den Vorgang. Diese Schaltfläche ersetzt die konfigurierte Bitcoin-Serverliste durch die Standardserver. Bewahre deshalb die Angaben zu deinem eigenen Endpunkt und Zertifikat auf, wenn du sie später wieder hinzufügen möchtest. Starte die App anschließend neu.

Mit den Standardservern nutzt du für Bitcoin-Abfragen und Transaktionsübermittlungen wieder öffentliche Infrastruktur. Um erneut ausschließlich deine Node zu verwenden, füge deinen Endpunkt hinzu, prüfe ihn, entferne die Standardserver und starte die App neu.