Mit der BitBoxBridge können unterstützte Web-Wallets auf einem Desktop-Computer oder Laptop mit deiner BitBox kommunizieren. Sie läuft nicht auf Smartphones oder Tablets. Für die normale Nutzung der BitBoxApp brauchst du keine Bridge.
Schlägt eine Verbindung über die Bridge fehl, prüfe zuerst, ob sich ihre lokale Statusseite auf deinem Computer öffnen lässt. Folge anschließend dem Abschnitt für dein Ergebnis. Manche Web-Wallets lassen sich ohne Bridge verbinden. Prüfe daher die Verbindungsanleitung deiner Wallet, bevor du die Bridge installierst oder neu installierst.
Bevor du beginnst
Öffne auf deinem Computer die offizielle Website oder Browser-Erweiterung deiner Wallet.
- Schließe die BitBoxApp und andere Wallet-Anwendungen, die möglicherweise auf deine BitBox zugreifen.
- Verbinde deine BitBox per USB. Wenn du ein Kabel verwendest, muss es auch Daten übertragen können. Nutze nach Möglichkeit einen USB-Anschluss direkt am Computer statt eines Hubs oder einer Dockingstation.
- Lass deine Firewall, dein Antivirenprogramm und die anderen Schutzfunktionen bei den ersten Prüfungen aktiviert. Einen gesonderten optionalen Antivirentest findest du weiter unten.
Für die Fehlersuche brauchst du keine geheimen Wallet-Daten
Gib niemals Wiederherstellungswörter, private Schlüssel, dein Gerätepasswort oder eine optionale Passphrase auf einer Website ein und lade kein Wallet-Backup hoch. Angaben zum Entsperren gibst du ausschließlich auf deiner BitBox ein. Setze das Gerät nicht zurück und stelle kein Backup wieder her, um ein Verbindungsproblem zu beheben. Brich den Vorgang ab, wenn eine Website dich dazu auffordert.
Prüfe, ob die BitBoxBridge erreichbar ist
- Öffne auf dem Computer, auf dem die Bridge installiert ist, einen neuen Browser-Tab.
- Gib http://127.0.0.1:8178/ in die Adressleiste ein und öffne die Seite. Diese Adresse verweist auf deinen eigenen Computer.
- Achte auf eine schlichte Seite, die mit BitBoxBridge v und einer Versionsnummer beginnt. Darunter stehen Einträge wie
GET /api/info. Die Versionsnummer kann vom folgenden Beispiel abweichen.

Wenn die Seite erscheint: Die Bridge ist erreichbar. Damit ist noch nicht bestätigt, dass sie auf deine BitBox zugreifen kann oder dass die Website eine Verbindungsfreigabe hat. Überspringe den nächsten Abschnitt und lies unter Wenn die Bridge erreichbar ist, aber die Wallet keine Verbindung herstellt weiter.
Lädt die Seite nicht oder erscheint eine unerwartete Seite, gehe zum nächsten Abschnitt. Notiere die genaue Fehlermeldung des Browsers, statt bereits ein bestimmtes Programm als Ursache anzunehmen.
Wenn die lokale Statusseite nicht lädt
- Prüfe, ob du die vollständige Adresse einschließlich
http://und:8178eingegeben hast. Versuche alternativ http://localhost:8178/. Notiere, ob nur eine der beiden Adressen funktioniert. - Ist die Bridge noch nicht installiert, folge der offiziellen Installationsanleitung für die BitBoxBridge. Lade sie nur von der offiziellen BitBox-Downloadseite oder aus den GitHub-Veröffentlichungen von BitBoxSwiss herunter. Schlägt die Installation fehl, lies den Abschnitt zu Installationsfehlern weiter unten.
- Ist die Bridge bereits installiert, speichere deine Arbeit und starte den Computer neu. Die Bridge startet normalerweise als Hintergrunddienst. Lass nach dem Neustart die Wallet-Anwendungen geschlossen und öffne die lokale Statusseite erneut.
Erscheint die Seite jetzt, fahre mit den Verbindungsprüfungen für die Web-Wallet fort. Andernfalls prüfe, ob eine konkrete Meldung deiner Sicherheitssoftware oder ein Browserfehler vorliegt, wie weiter unten beschrieben. Wiederholtes Neuinstallieren zeigt dir nicht, warum eine Verbindung blockiert wird.
Wenn die Installation unterbrochen oder die Bridge entfernt wurde, kann eine Neuinstallation sinnvoll sein. Folge dafür der Installationsanleitung. Musst du zunächst eine bestehende Installation entfernen, frage den Support nach den Schritten für dein Betriebssystem. Bist du unsicher, ob der Dienst installiert ist oder blockiert wird, teile dem Support das Ergebnis des Statusseitentests mit, bevor du Software entfernst.
Wenn die Bridge erreichbar ist, aber die Wallet keine Verbindung herstellt
- Kehre zur offiziellen Website oder Browser-Erweiterung deiner Wallet zurück und wähle die Verbindung mit einer Hardware-Wallet. Lass die BitBoxApp und andere Wallet-Anwendungen geschlossen.
- Trenne deine BitBox vom Computer, verbinde sie erneut und starte den Verbindungsvorgang in der Wallet noch einmal. Entsperre die BitBox auf dem Gerät, sobald du dazu aufgefordert wirst.
- Erscheint ein Kopplungscode, vergleiche den vollständigen Code auf der BitBox mit dem Code in der Wallet-Anwendung. Bestätige nur, wenn beide übereinstimmen. Lehne die Kopplung bei einer Abweichung ab und brich den Vorgang ab.
- Prüfe anhand des nächsten Abschnitts, ob eine Freigabeanfrage der Bridge vorliegt. Sie erscheint nicht bei jeder Verbindung.
Findet die Wallet das Gerät weiterhin nicht, prüfe, ob dein Betriebssystem es über USB erkennt. Verwende dafür den Abschnitt zur Geräteerkennung in der Anleitung für macOS, Windows oder Linux. Lass die Schutzfunktionen deines Computers dabei aktiviert.
- Das Betriebssystem erkennt die BitBox nicht: Probiere gegebenenfalls ein anderes datenfähiges Kabel oder einen anderen USB-Anschluss. Wird die BitBox weiterhin nicht erkannt, teile dem Support dieses Ergebnis mit. Eine erreichbare Bridge-Statusseite allein behebt kein Problem mit der USB-Erkennung.
- Das Betriebssystem erkennt die BitBox, die Wallet aber nicht: Notiere die Fehlermeldung der Wallet, falls eine erscheint, und prüfe die Verbindungsfreigabe sowie mögliche Blockierungen. Die Geräteerkennung allein bestätigt nicht, dass die Wallet auf die BitBox zugreifen kann.
Prüfe eine Freigabeanfrage der Bridge
Die Bridge kann dich fragen, ob eine Website eine Verbindung zu deiner BitBox herstellen darf. Diese Freigabe ist etwas anderes als der Vergleich eines Kopplungscodes auf dem Gerät oder die Bestätigung einer Transaktion.
Die Anfrage nennt den Hostnamen der Website, beispielsweise Allow [website host] to connect to your BitBox? Erlaube die Verbindung nur, wenn du sie gerade selbst gestartet hast und der angezeigte Hostname mit der offiziellen Website des gewünschten Dienstes übereinstimmt. Lehne eine unbekannte oder unerwartete Anfrage ab und brich den Verbindungsvorgang ab.
- Windows mit Bridge 1.6.1: Die Anfrage erscheint in einem Windows-Dialog mit dem Titel BitBoxBridge und einer Ja/Nein-Auswahl. Für die Antwort steht nur begrenzt Zeit zur Verfügung. Hast du die Anfrage verpasst, starte den Verbindungsvorgang in der Wallet erneut, um die Freigabe noch einmal anzufordern.
- macOS und Linux mit Bridge 1.6.0: Die Anfrage öffnet sich auf einer lokalen Browserseite mit den Schaltflächen Accept und Reject. Prüfe den anfragenden Hostnamen, bevor du mit Accept zustimmst.
Einige Hosts sind bereits zugelassen. Wenn keine Anfrage erscheint, bedeutet das daher nicht automatisch, dass ein Fehler vorliegt. Lehnst du eine Anfrage ab, erhält die Wallet diese Freigabe nicht. Erscheint eine erwartete Anfrage nicht und bleibt die Verbindung blockiert, teile dem Support deine Bridge-Version und dein Betriebssystem mit, statt Schutzfunktionen zu deaktivieren, um die Verbindung zu erzwingen.
Prüfe, ob Sicherheitssoftware oder der Browser die Verbindung blockiert
Sieh zuerst in den Website-Berechtigungen deines Browsers sowie in den Benachrichtigungen oder dem Blockierungsverlauf deiner Sicherheitssoftware nach. Suche nach einem Eintrag, der ausdrücklich die Bridge, die Wallet-Website oder 127.0.0.1:8178 nennt, und notiere den genauen Wortlaut. Eine fehlgeschlagene Verbindung allein zeigt nicht, ob ein VPN, eine Firewall oder ein Antivirenprogramm die Ursache ist.
Meldet ein Programm eine konkrete Blockierung, frage den Support oder den Softwareanbieter, ob eine gezielte Freigabe sinnvoll ist. Lege keine pauschale Ausnahme an und erlaube keine unbekannte Website. Verwaltet dein Arbeitgeber oder deine Organisation den Computer, lass die Systemadministration die Ursache prüfen, statt selbst die Schutzeinstellungen zu ändern.
Optional: Teste, ob das Antivirenprogramm die lokale Statusseite beeinflusst
Wenn sich die lokale Seite auch nach den Adressprüfungen und dem Neustart nicht öffnen lässt und die Benachrichtigungen keine Erklärung liefern, kann ein kurzer Antivirentest einen weiteren Hinweis geben. Führe ihn nur auf deinem eigenen, vertrauenswürdigen Computer durch, auf dem die Bridge bereits aus einer offiziellen Quelle installiert ist. Verzichte auf den Test, wenn das Antivirenprogramm eine Bedrohung meldet oder die Installationsdatei in Quarantäne verschoben hat. Ist die lokale Seite bereits erreichbar, hilft dieser Test nicht dabei, ein USB-Problem oder eine fehlende Verbindungsfreigabe der Web-Wallet zu erkennen.
Vergewissere dich vor dem Test anhand der Anleitung deines Antivirenanbieters, wie du die betreffende Schutzfunktion pausierst und wieder aktivierst. Bist du unsicher, frage den Support oder den Anbieter, statt fortzufahren.
- Trenne deine BitBox vom Computer. Schließe Wallet-Anwendungen, nicht benötigte Programme und andere Browser-Tabs. Lass nur den Tab mit der lokalen Statusseite geöffnet.
- Pausiere kurz ausschließlich die Schutzfunktion des Antivirenprogramms, die du untersuchen möchtest. Lass Firewall, VPN und andere Schutzebenen unverändert. Deinstalliere das Antivirenprogramm nicht und umgehe keinen Manipulationsschutz.
- Lade
http://127.0.0.1:8178/einmal neu und notiere, ob die Bridge-Statusseite erscheint. Öffne während des Tests keine anderen Websites, lade keine Dateien herunter, installiere nichts und öffne keine Wallet. Gib keine geheimen Daten ein und signiere nichts. - Aktiviere den Schutz sofort wieder, unabhängig davon, ob die Seite geladen wurde, und vergewissere dich, dass er eingeschaltet ist. Lade dieselbe Adresse mit aktiviertem Schutz noch einmal neu und notiere das Ergebnis.
- Die Seite öffnet sich nur bei pausiertem Schutz: Das deutet darauf hin, dass diese Schutzfunktion die Verbindung beeinflusst. Es beweist aber nicht, dass eine Warnung ein Fehlalarm ist. Lass den Schutz aktiviert und teile dem Support oder dem Antivirenanbieter die Ergebnisse mit, damit eine gezielte Lösung geprüft werden kann.
- Das Ergebnis ändert sich nicht: Der Test hat diese Schutzfunktion nicht als Ursache für die unerreichbare lokale Seite identifiziert. Lass sie aktiviert und melde dem Support das unveränderte Ergebnis. Eine Blockierung an anderer Stelle der Verbindung ist dadurch nicht ausgeschlossen.
Eine funktionierende Verbindung bei deaktiviertem Schutz ist ein Diagnoseergebnis, keine dauerhafte Lösung. Aktiviere zuvor ausgeschaltete Schutzfunktionen wieder, bevor du fortfährst.
Wenn die Installation fehlschlägt, auch bei „The pipe is being closed“
Diese Fehlermeldung allein zeigt nicht, dass ein Antivirenprogramm die Ursache ist. Schließe das fehlgeschlagene Installationsprogramm und notiere die genaue Meldung sowie den Schritt, bei dem sie erschienen ist. Vergewissere dich, dass du die Datei von der offiziellen BitBox-Downloadseite heruntergeladen und das Paket für dein Betriebssystem gewählt hast.
Lass dein Antivirenprogramm und die anderen Schutzfunktionen aktiviert. Meldet die Sicherheitssoftware einen Fund oder verschiebt sie die Installationsdatei in Quarantäne, umgehe die Warnung nicht und lege keine Ausnahme an, um die Installation abzuschließen. Kontaktiere den Support mit dem Dateinamen, deinem Betriebssystem, der Fehlermeldung und einer gegebenenfalls angezeigten Benachrichtigung der Sicherheitssoftware. Auch wenn keine solche Benachrichtigung erscheint, sende bei weiterhin fehlgeschlagener Installation dieselben Angaben, ohne von einer bestimmten Ursache auszugehen.
Wann die Verbindung hergestellt ist und wann du Hilfe brauchst
Die Verbindung ist hergestellt, wenn der Verbindungsvorgang für die Hardware-Wallet abgeschlossen ist und die Wallet das gewünschte Konto anzeigt. Die Bridge-Statusseite allein bestätigt das nicht. Zum Testen der Verbindung musst du weder Guthaben senden noch eine Transaktion signieren. Bevor du eine Adresse für eine Zahlung verwendest, prüfe sie auf deiner BitBox anhand der Empfangsanleitung deiner Wallet.
Schlägt die Verbindung weiterhin fehl oder stimmen Kopplungscodes nicht überein, kontaktiere den BitBox Support. Nenne die Angaben, die dir vorliegen. Du musst nicht erst alle Prüfungen abschließen, bevor du um Hilfe bittest:
- Dein Betriebssystem und seine Version, deinen Browser und seine Version sowie die verwendete Wallet-Website oder Browser-Erweiterung.
- Dein BitBox-Modell und die Firmware-Version, soweit bekannt.
- Die Bridge-Version auf der lokalen Statusseite oder den Hinweis, dass keine der beiden lokalen Adressen lädt.
- Den fehlgeschlagenen Schritt, die genaue Fehlermeldung, ob das Betriebssystem die BitBox erkennt und ob eine Freigabeanfrage erschienen ist.
- Konkrete Meldungen deiner Sicherheitssoftware und die bereits ausprobierten Schritte.
Sende niemals Wiederherstellungswörter, Wallet-Backups, private Schlüssel, Passwörter oder Passphrasen. Entferne nicht benötigte Kontoinformationen und andere private Angaben aus Screenshots, bevor du sie weitergibst.