Du kannst die BitBoxBridge entfernen, wenn du sie für eine unterstützte Web-Wallet nicht mehr brauchst oder eine saubere Neuinstallation nötig ist, um ihre Installation zu reparieren. Dabei wird weder die BitBoxApp deinstalliert noch der Inhalt deiner BitBox gelöscht oder dein Wallet-Backup verändert.
Folge den Schritten für dein Betriebssystem. Du brauchst dafür weder Wiederherstellungswörter noch ein Gerätepasswort oder eine optionale Passphrase.
Bevor du beginnst
- Trenne deine BitBox vom Computer und schließe Browserfenster, in denen du eine Web-Wallet verwendest.
- Stelle sicher, dass du Administratorrechte auf dem Computer hast. Bei einem verwalteten Arbeitscomputer bitte die zuständige Administration, die Software zu entfernen.
- Wenn sich eine Wallet nicht verbindet, die Bridge-Statusseite aber funktioniert, prüfe zuerst die Verbindung. Ein laufender Dienst allein bestätigt nicht, dass Browser oder Wallet das Gerät verwenden können. Deinstalliere die BitBoxBridge nicht allein deshalb, weil eine Wallet einen ungewohnten Kontostand anzeigt.
Unter Windows deinstallieren
- Öffne das Startmenü und wähle Einstellungen.
- Öffne Apps und anschließend je nach Windows-Version Installierte Apps oder Apps & Features.
- Suche BitBoxBridge. Öffne das Optionsmenü des Eintrags oder wähle den Eintrag aus und anschließend Deinstallieren.
- Folge den Anweisungen und warte, bis die Deinstallation abgeschlossen ist. Bestätige eine Windows-Administratorabfrage nur für die Deinstallation, die du selbst gestartet hast. Wenn das Deinstallationsprogramm einen Neustart verlangt, führe ihn aus, bevor du das Ergebnis prüfst.
Das Deinstallationsprogramm beendet und entfernt den BitBoxBridge-Hintergrunddienst. Öffne danach erneut die Liste der installierten Apps und prüfe, dass die BitBoxBridge dort nicht mehr aufgeführt ist.
Unter macOS deinstallieren
Wenn du die BitBoxBridge mit dem offiziellen Installationspaket eingerichtet hast, entferne sowohl die Konfiguration des Hintergrunddienstes als auch den Programmordner. Starte deinen Mac anschließend neu. Lösche nur die unten genau benannten Einträge und lasse andere Dienstdateien und Ordner unverändert.
Die Abbildungen zeigen den Finder auf Englisch. Die Schritte nennen die entsprechenden deutschen Menüpunkte; die Datei- und Ordnernamen bleiben gleich.
Konfiguration des Hintergrunddienstes entfernen
- Öffne den Finder und wähle in der Menüleiste Gehe zu > Gehe zum Ordner….
- Gib
/Library/LaunchDaemons/ein und drücke die Eingabetaste, um diesen Systemordner zu öffnen.

- Suche die Datei
ch.shiftcrypto.bitboxbridge.plist. Wähle genau diese Datei aus und verschiebe sie in den Papierkorb. Wenn macOS eine Bestätigung verlangt, gib das Administratorpasswort deines Mac ein.
Wenn die Datei fehlt, lösche keine ähnlich benannte Datei. Prüfe stattdessen als Nächstes den Programmordner. Verweigert der Finder das Entfernen, brich den Vorgang ab und teile dem Support die Fehlermeldung mit. Ändere nicht die Zugriffsrechte des Systemordners, um das Löschen zu erzwingen.
Programmordner entfernen und Mac neu starten
- Wähle im Finder erneut Gehe zu > Gehe zum Ordner…. Gib
/opt/shiftcrypto/ein und drücke die Eingabetaste.

- Suche den Ordner
bitbox-bridgeund verschiebe ihn in den Papierkorb. Lasse den übergeordneten Ordnershiftcryptound alle anderen Inhalte unverändert. Bestätige das Entfernen mit dem Administratorpasswort deines Mac, falls macOS dich dazu auffordert.

- Speichere deine übrige offene Arbeit und wähle Apple-Menü > Neustart…. Warte den Neustart ab, bevor du prüfst, ob die BitBoxBridge noch antwortet.
Fehlt der Programmordner, lasse andere Ordner unverändert und starte den Mac trotzdem neu. Das Löschen von Dateien allein beendet einen bereits laufenden Prozess möglicherweise nicht. Der Neustart gehört deshalb zu diesem Verfahren.
Unter Linux deinstallieren
Die folgenden Befehle gelten für die Installation mit dem offiziellen .deb- oder .rpm-Paket. Hast du die BitBoxBridge manuell aus einem Archiv oder aus dem Quellcode installiert, belegen diese Befehle nicht, dass deine manuelle Installation entfernt wurde. Kontaktiere den Support für die passenden Schritte.
- Öffne das Terminal und gib den Befehl für deine Paketverwaltung ein.
Ubuntu oder Debian:
sudo apt-get remove bitbox-bridgeFedora:
sudo dnf remove bitbox-bridgeopenSUSE:
sudo zypper remove bitbox-bridge- Gib bei Aufforderung das Passwort deines Computerkontos ein, mit dem du Administratoraktionen bestätigst. Während der Eingabe zeigt das Terminal möglicherweise keine Zeichen an. Prüfe vor der Bestätigung die Liste der zu entfernenden Pakete: Dort sollte
bitbox-bridgegenannt sein. Wenn unerwartet weitere Software entfernt werden soll, brich den Vorgang ab und frage beim Support nach. - Warte, bis die Paketverwaltung den Vorgang ohne Fehler abgeschlossen hat. Das Entfernungsskript des Pakets beendet die BitBoxBridge und deaktiviert ihren automatischen Start. Meldet die Paketverwaltung, dass das Paket nicht installiert ist, schließt das eine separate manuelle Installation nicht aus.
Ergebnis prüfen
- Öffne nach dem Entfernen einen Browser auf demselben Computer. Warte unter macOS zuerst den erforderlichen Neustart ab; unter Windows gilt das auch für einen vom Deinstallationsprogramm angeforderten Neustart.
- Gib http://127.0.0.1:8178/ in die Adressleiste ein und lade die Seite neu. Die BitBoxBridge-Statusseite sollte jetzt nicht mehr laden.
Wenn keine Verbindung zustande kommt, ist die BitBoxBridge unter ihrer üblichen lokalen Adresse nicht mehr erreichbar. Das allein beweist jedoch nicht, dass jede Installationsdatei entfernt wurde. Prüfe deshalb auch, ob die Entfernungsschritte für dein Betriebssystem erfolgreich abgeschlossen wurden. Wird nach dem Neuladen weiterhin die BitBoxBridge-Statusseite angezeigt, kontaktiere den BitBox Support mit deinem Betriebssystem, der Installationsmethode und dem fehlgeschlagenen Schritt. Lösche nicht wiederholt Dateien und setze deine Hardware-Wallet nicht zurück.
BitBoxBridge erneut installieren
Wenn die Entfernung abgeschlossen ist und du neu installieren möchtest, folge BitBoxBridge installieren. Lade dort das offizielle Paket herunter, installiere es und prüfe die lokale Statusseite. Versuche anschließend erneut, die Hardware-Wallet nach der Anleitung deiner gewählten Wallet zu verbinden. Dafür musst du die BitBox weder zurücksetzen noch ein Backup wiederherstellen.