Wenn deine BitBox02 keine Verbindung zu deinem Computer herstellt oder von der BitBoxApp nicht erkannt wird, lässt sich das Problem in den meisten Fällen schnell und einfach beheben.

Diese Anleitung führt dich Schritt für Schritt durch die häufigsten Ursachen – von einfachen Basisprüfungen bis hin zu betriebssystem­spezifischen Lösungen für macOS, Windows und Linux. So kannst du schnell eingrenzen, ob das Problem an der USB-Verbindung, der Software oder dem Betriebssystem liegt.

Zuerst prüfen: Sind App und Firmware aktuell?

Bevor du mit der Fehlerbehebung beginnst, stelle bitte sicher, dass:

• du die neueste Version der BitBoxApp verwendest, und
• die Firmware deiner BitBox02 aktuell ist.

Schnelle Checks

Beginne immer mit diesen grundlegenden Schritten. In den meisten Fällen lässt sich das Problem hier bereits lösen.

1. Anderes USB-Kabel ausprobieren
   Defekte USB-Kabel sind die häufigste Ursache für Verbindungsprobleme – auch bei neuen Kabeln. Teste wenn möglich ein anderes, kompatibles Kabel.
2. Direkte USB-Verbindung verwenden
   Schließe die BitBox02 direkt an einen USB-Port deines Computers an.
   Vermeide USB-Hubs, Dockingstationen oder Verlängerungskabel.
3. USB-Port wechseln
   Probiere einen anderen USB-Anschluss an deinem Computer aus.
4. Ausrichtung prüfen
   Schließe die BitBox02 so an, dass der Bildschirm nach oben zeigt.
5. Computer neu starten
   Ein Neustart kann temporäre USB- oder Treiberprobleme beheben.
6. An einem anderen Gerät testen
   Wenn möglich, verbinde deine BitBox02 mit:
   1. einem anderen Computer oder
   2. einem Android-Smartphone.

So kannst du feststellen, ob das Problem vom Computer oder von der BitBox02 selbst verursacht wird.

Weitere Lösungsansätze

Wenn die schnellen Checks nicht geholfen haben, versuche Folgendes:

• Konfliktverursachende Software aktualisieren
  Programme wie Citrix Workspace können die USB-Geräteerkennung stören. Stelle sicher, dass solche Anwendungen auf dem neuesten Stand sind.
• USB-Treiber aktualisieren (Windows)
  Öffne den Geräte-Manager und prüfe, ob Updates für deine USB-Controller verfügbar sind.
• Sicherheitssoftware testweise deaktivieren
  Antivirenprogramme oder Firewalls können neue USB-Geräte blockieren.
  Deaktiviere sie kurzzeitig zu Testzwecken und aktiviere sie anschließend sofort wieder.
  Wenn dies das Problem löst, füge die BitBoxApp zur Ausnahmeliste hinzu.
• BitBoxApp neu installieren
  Erkennt dein Betriebssystem die BitBox02, die BitBoxApp jedoch nicht, könnte die Installation beschädigt sein.
  Lade die BitBoxApp neu von der offiziellen Website herunter und installiere sie erneut.
• Displayschutzfolie entfernen
  Falls sich noch eine Schutzfolie auf dem Bildschirm der BitBox02 befindet, entferne diese bitte.
   

Prüfen, ob dein Betriebssystem die BitBox02 erkennt

Auch wenn die BitBoxApp dein Gerät nicht anzeigt, kann es sein, dass dein Betriebssystem die BitBox02 bereits erkennt. Dieser Unterschied ist entscheidend, um festzustellen, ob ein Hardware- oder Softwareproblem vorliegt.

macOS

1. Öffne die Terminal-App.
2. Führe folgenden Befehl aus:

   ioreg -p IOUSB -l -w 0 | grep "BitBox"

3. Wird die BitBox02 erkannt, erscheint ein Eintrag mit „BitBox“.

Windows

1. Öffne den Geräte-Manager.
2. Klappe USB-Controller auf.
3. Suche nach USB Composite Device.
4. Rechtsklick → Eigenschaften → Tab Details.
5. Wähle Hardware-IDs aus.

Wenn VID_03EB und PID_2403 angezeigt werden, erkennt Windows deine BitBox02.

Linux

Wenn du Linux verwendest und deine BitBox02 vom BitBoxApp nicht erkannt wird, helfen dir die folgenden Schritte dabei festzustellen, ob es sich um ein Hardware-Problem oder um fehlende USB-Berechtigungen handelt.

Schritt 1: Prüfen, ob Linux die BitBox02 erkennt

Überprüfe zunächst, ob dein Betriebssystem das Gerät grundsätzlich erkennt.

1. Öffne ein Terminal.
2. Führe folgenden Befehl aus:

   lsusb

3. Suche nach einem Eintrag mit BitBox oder der Vendor- und Product-ID:

   03eb:2403

• Wenn die BitBox02 nicht angezeigt wird, liegt das Problem sehr wahrscheinlich am USB-Kabel, USB-Port, Adapter oder an der Hardware.
• Wenn die BitBox02 angezeigt wird, erkennt Linux das Gerät korrekt, und das Problem hängt sehr wahrscheinlich mit USB-Zugriffsrechten zusammen.

Schritt 2: BitBox02 wird erkannt, aber nicht im BitBoxApp angezeigt

Unter Linux kommuniziert das BitBoxApp über USB-HID-Schnittstellen mit der BitBox02. Fehlen die erforderlichen Berechtigungen, erkennt das Betriebssystem das Gerät zwar, das BitBoxApp kann jedoch keine Verbindung herstellen.

Dieses Problem lässt sich durch das Einrichten der richtigen udev-Regeln beheben.

Es gibt zwei unterstützte Möglichkeiten, diese Regeln zu installieren. Beide führen zum gleichen Ergebnis, unterscheiden sich jedoch darin, wie die Regeln angewendet und gewartet werden.

Ansatz 1 (empfohlen): udev-Regeln über das offizielle GitHub-Skript installieren

Dies ist der empfohlene Ansatz, insbesondere wenn du eine automatisierte und distributionsabhängige Einrichtung bevorzugst.

Das Skript:

• installiert die korrekten udev-Regeln
• verwendet die offiziellen Dateinamen und Regeldefinitionen
• entspricht der Einrichtung, die auch von Distributionspaketen verwendet wird
• reduziert das Risiko manueller Fehler

Lade das offizielle udev-Skript aus unserem GitHub-Repository herunter und führe es aus:

frontends/qt/resources/deb-afterinstall.sh

Nach dem Ausführen des Skripts:

• trenne die BitBox02 vom USB-Port und verbinde sie erneut
• starte das BitBoxApp neu
• melde dich ab und wieder an oder starte das System neu, falls erforderlich

Ansatz 2: udev-Regeln manuell installieren

Dieser Ansatz richtet sich an fortgeschrittene Nutzer, die volle Kontrolle bevorzugen oder das Skript nicht ausführen können.

Führe die folgenden Befehle in einem Terminal aus:

sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null <<EOF
SUBSYSTEM=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl"
EOF

sudo tee /etc/udev/rules.d/54-hidraw-bitbox02.rules > /dev/null <<EOF
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl"
EOF

Lade anschließend die udev-Regeln neu und wende sie an:

sudo udevadm control --reload
sudo udevadm trigger

Trenne danach die BitBox02 vom USB-Port und verbinde sie erneut.

Wenn die BitBox02 weiterhin nicht erkannt wird

Auf manchen Linux-Distributionen sind zusätzliche Gruppenberechtigungen erforderlich.

Füge deinen Benutzer zur Gruppe plugdev hinzu:

sudo usermod -aG plugdev $USER

Melde dich anschließend ab und wieder an oder starte dein System neu.

Abschließende Prüfungen

Nachdem du einen der beiden Ansätze durchgeführt hast:

• starte das BitBoxApp neu
• verbinde die BitBox02 erneut
• starte das System neu, falls das Problem weiterhin besteht

Wenn die BitBox02 danach immer noch nicht erkannt wird, fahre mit dem Abschnitt „Immer noch Probleme?“ weiter und kontaktiere den Support.

Immer noch Probleme?

Wenn du alle Schritte in dieser Anleitung durchgeführt hast, hilft dir unser Support-Team gerne weiter.

Bitte sende uns folgende Informationen, damit wir dir effizient helfen können:

• dein Computermodell und die Betriebssystemversion
• die verwendete BitBoxApp-Version
• eine kurze Beschreibung der bereits durchgeführten Schritte
• die BitBoxApp-Logdateien

Anleitung zum Exportieren der Logdateien:
So findest und exportierst du die Support-Dateien der BitBoxApp 

FAQ – Häufige Fragen

Ist meine BitBox02 defekt, wenn sie nicht erkannt wird?

In den meisten Fällen nicht. Verbindungsprobleme werden meist durch Kabel, USB-Ports, Treiber, Berechtigungen oder Softwarekonflikte verursacht. Hardwaredefekte sind selten.

Warum erkennt mein Computer die BitBox02, aber die BitBoxApp nicht?

Wenn das Betriebssystem die BitBox02 erkennt, liegt das Problem sehr wahrscheinlich an der BitBoxApp, fehlenden Berechtigungen oder blockierender Sicherheitssoftware.

Kann ich durch Verbindungsprobleme meine Coins verlieren?

Nein. Deine Coins werden nicht auf der BitBox02, sondern auf der Blockchain gespeichert. Solange deine Wiederherstellungswörter sicher aufbewahrt sind, sind deine Guthaben nicht gefährdet.

Die BitBox02 funktioniert an einem Android-Gerät, aber nicht an meinem Computer – was bedeutet das?

Das zeigt, dass die BitBox02 selbst einwandfrei funktioniert. Das Problem liegt fast sicher an deinem Computer oder dessen Software-Konfiguration.

Wann sollte ich den Support kontaktieren?

Wenn du:

• mehrere Kabel und Geräte getestet hast,
• bestätigt hast, dass dein Betriebssystem die BitBox02 nicht erkennt, oder
• alle Schritte in dieser Anleitung durchgeführt hast,

kontaktiere bitte unseren Support.