Installiere die BitBoxBridge, wenn die Verbindungsanleitung deiner Web-Wallet sie voraussetzt. Die Anwendung läuft unter Windows, macOS und Linux im Hintergrund und ermöglicht unterstützte Verbindungen über den Browser. Für die normale Nutzung der BitBoxApp brauchst du sie nicht.
Nach der Installation startet die BitBoxBridge automatisch und läuft im Hintergrund weiter – auch nach einem Neustart deines Computers. Du musst sie normalerweise nicht selbst öffnen. Hier erfährst du, wie du sie installierst und zunächst prüfst, ob sie auf deinem Computer erreichbar ist. Anschließend kannst du deine Wallet verbinden.
1. BitBoxBridge herunterladen
- Öffne auf dem Computer, auf dem du die Web-Wallet verwenden möchtest, die offizielle BitBox-Downloadseite. Scrolle unter die BitBoxApp-Downloads zum Abschnitt Lade die BitBox Bridge.
- Wähle den Download für dein Betriebssystem. Unter Linux öffnest du die Linux-Auswahl und wählst das
.deb-Paket für Ubuntu oder Debian bzw. das.rpm-Paket für Fedora oder openSUSE. Diese Anleitung beschreibt die Installation mit diesen Paketen, nicht die manuelle Installation aus einem Archiv.

Verwende die Version, die für dein Betriebssystem angeboten wird. Die Versionsnummern für Windows, macOS und Linux sind nicht immer gleich. Fortgeschrittene Nutzer finden die veröffentlichten Versionen auch im offiziellen BitBoxBridge-Repository auf GitHub.
Nur aus offizieller Quelle herunterladen
Lade die BitBoxBridge nur von der offiziellen BitBox-Website oder aus dem BitBoxSwiss-Repository auf GitHub herunter. Zeigt dein Betriebssystem eine Sicherheitswarnung an, die du nicht verstehst, brich den Vorgang ab und kontaktiere den Support. Umgehe die Warnung nicht und deaktiviere keine Schutzfunktionen.
Optional: Download vor der Installation prüfen
Mit einer SHA-256-Prüfsumme kannst du die heruntergeladene Datei mit der von BitBox angegebenen Datei vergleichen. Wähle auf der Downloadseite im Abschnitt zur BitBox Bridge die Option Überprüfe die Prüfsummen. Achte darauf, dass du nicht die Prüfsummen aus dem separaten BitBoxApp-Abschnitt verwendest.
- Suche die Prüfsumme für genau die Datei und das Betriebssystem, die du ausgewählt hast.
- Berechne die SHA-256-Prüfsumme deiner heruntergeladenen Datei. Öffne unter Windows PowerShell, unter macOS oder Linux das Terminal. Verwende den passenden Befehl unten und ersetze den Beispielpfad in Anführungszeichen durch den vollständigen Pfad zu deiner Datei. Prüfe die ursprüngliche Download-Datei, bevor du sie entpackst oder installierst.
Windows:
Get-FileHash -Algorithm SHA256 -LiteralPath "C:\path\to\downloaded-file.exe"macOS:
shasum -a 256 "/path/to/downloaded-file.pkg"Linux:
sha256sum "/path/to/downloaded-file.deb"Wenn du ein RPM-Paket heruntergeladen hast, verwende stattdessen den tatsächlichen Dateinamen mit der Endung .rpm.
- Vergleiche den gesamten berechneten Hashwert mit der Prüfsumme auf der offiziellen Seite. Groß- und Kleinschreibung spielen dabei keine Rolle. Stimmen die Werte nicht überein, führe die Datei nicht aus. Lade sie erneut aus der offiziellen Quelle herunter. Besteht die Abweichung weiterhin, kontaktiere den Support.
2. Heruntergeladene Datei installieren
Für die Installation können Administratorrechte erforderlich sein. Folge den Schritten für dein Betriebssystem und lasse die Schutzfunktionen deines Computers aktiviert.
Windows
- Öffne den Ordner Downloads oder den anderen Speicherort deiner Datei. Doppelklicke auf die heruntergeladene
.exe-Installationsdatei der BitBoxBridge. - Folge den Installationsanweisungen. Wenn Windows eine Administratorbestätigung verlangt, erteile sie nur für die Installation, die du bewusst mit der Datei aus der offiziellen Quelle gestartet hast. Warte, bis die Installation abgeschlossen ist.
macOS
- Öffne im Finder den Ordner mit der heruntergeladenen BitBoxBridge-
.pkg-Datei und doppelklicke darauf. - Folge dem Installationsprogramm bis zum Abschluss. Wenn macOS dich dazu auffordert, gib das Administratorpasswort deines Mac in der macOS-Abfrage ein. Gemeint ist das Passwort deines Computers, nicht das Gerätepasswort deiner BitBox.
Ubuntu, Debian, Fedora und openSUSE
- Öffne den Ordner mit der heruntergeladenen
.deb- oder.rpm-Datei und öffne sie mit dem Paketinstallationsprogramm deiner Distribution. - Wähle die Installationsaktion, bestätige sie bei Bedarf mit deinen Administratorrechten und warte auf die Abschlussmeldung der Paketverwaltung. Wenn dein System kein passendes Installationsprogramm anbietet oder einen Fehler meldet, brich den Vorgang ab. Teile dem Support deine Distribution und den genauen Fehlertext mit.
Das Installationsprogramm startet die BitBoxBridge als Hintergrunddienst. Dabei öffnet sich normalerweise kein eigenes Anwendungsfenster. Prüfe als Nächstes, ob der Dienst erreichbar ist.
3. Prüfen, ob die BitBoxBridge läuft
- Öffne auf demselben Computer einen Browser und gib http://127.0.0.1:8178/ in die Adressleiste ein. Diese Adresse verweist auf deinen eigenen Computer. Alternativ kannst du http://localhost:8178/ verwenden.
- Es sollte eine schlichte Statusseite erscheinen, die mit BitBoxBridge v und einer Versionsnummer beginnt. Darunter stehen Einträge wie
GET /api/infoundGET /api/v1/devices. Das folgende Beispiel zeigt Version 1.6.0; deine Versionsnummer kann davon abweichen.

Diese Antwort bestätigt, dass die BitBoxBridge läuft und über deinen Browser erreichbar ist. Für diese Prüfung muss die BitBox nicht angeschlossen sein. Die Statusseite bestätigt noch nicht, dass eine Web-Wallet dein Gerät erkennt oder verwenden kann.
Wenn die Seite nicht lädt, starte deinen Computer einmal neu und öffne die Adresse erneut. Bleibt die Seite unerreichbar, kontaktiere den Support mit deinem Betriebssystem, dem Namen der heruntergeladenen Datei und etwaigen Fehlermeldungen aus Installation oder Browser. Setze deine BitBox nicht zurück und stelle kein Backup wieder her, um ein Installationsproblem der BitBoxBridge zu beheben.
Mit deiner Web-Wallet verbinden
Sobald die Statusseite antwortet, kehre zur Verbindungsanleitung deiner gewünschten Web-Wallet zurück. Schließe die BitBoxApp und andere Wallet-Anwendungen, die auf das Gerät zugreifen könnten. Folge dann der Anleitung für die Hardware-Wallet-Verbindung und verbinde und entsperre deine BitBox, wenn du dazu aufgefordert wirst.
Keine geheimen Wallet-Daten auf Websites eingeben
Gib niemals Wiederherstellungswörter, einen privaten Schlüssel, dein BitBox-Gerätepasswort oder eine optionale Passphrase in eine Web-Wallet ein. Lade auch kein Wallet-Backup hoch. Gib Gerätepasswort und Passphrase nur auf der BitBox ein. Fragt eine Website nach geheimen Wallet-Daten, brich den Vorgang ab und schließe die Seite.
Wenn die Statusseite funktioniert, die Wallet sich aber nicht verbindet, lasse die funktionierende Installation zunächst bestehen. Prüfe die Verbindung zwischen Gerät, Browser und Wallet, bevor du neu installierst. Bei gewöhnlichen Verbindungsfehlern hilft die Anleitung zur Fehlerbehebung bei der BitBoxBridge. Bei einer Sicherheitswarnung oder wenn du nicht weißt, wie du fortfahren sollst, kontaktiere den BitBox Support.
Wurde die Installation unterbrochen oder empfiehlt der Support eine saubere Neuinstallation, folge zuerst BitBoxBridge deinstallieren. Kehre danach zu dieser Anleitung zurück, installiere das offizielle Paket und wiederhole die lokale Statusprüfung. Dafür musst du weder die BitBox zurücksetzen noch auf ihr Backup zugreifen.