Wenn deine BitBox von der BitBoxApp auf Linux nicht erkannt wird, liegt das häufig an fehlenden USB-Zugriffsrechten.

Linux kann die BitBox bereits korrekt als USB-Gerät erkennen, während die BitBoxApp trotzdem nicht mit ihr kommunizieren kann. Das passiert meist, wenn die erforderlichen udev-Regeln fehlen.

In dieser Anleitung prüfst du zuerst, ob Linux deine BitBox erkennt. Danach erfährst du, wie du die benötigten udev-Regeln installierst.


Bevor du beginnst

Bevor du die USB-Verbindung weiter prüfst, stelle sicher, dass:

Veraltete Versionen der BitBoxApp oder der Firmware können dazu führen, dass deine BitBox nicht richtig erkannt wird, auch wenn Linux das USB-Gerät grundsätzlich erkennt.

 

Schnelle Prüfungen

Beginne mit diesen einfachen Schritten, bevor du Linux-Berechtigungen oder Systemeinstellungen änderst.

  1. Verwende ein anderes USB-Kabel.
  2. Verbinde deine BitBox direkt mit deinem Computer.
  3. Entferne USB-Hubs, Dockingstations, Adapter oder Verlängerungskabel.
  4. Verwende einen anderen USB-Anschluss.
  5. Verbinde die BitBox so, dass der Bildschirm nach oben zeigt.
  6. Starte deinen Computer neu.
  7. Teste deine BitBox nach Möglichkeit an einem anderen Computer oder Android-Smartphone.

Wenn deine BitBox an einem anderen Gerät funktioniert, ist die BitBox selbst sehr wahrscheinlich in Ordnung. Das Problem liegt dann vermutlich an deinem Linux-System, den USB-Berechtigungen, deiner Distribution oder der Software-Konfiguration.

 

Prüfe, ob Linux deine BitBox erkennt

Prüfe zuerst, ob Linux deine BitBox als angeschlossenes USB-Gerät erkennt.

  1. Verbinde deine BitBox mit deinem Linux-Computer.
  2. Öffne ein Terminal.
  3. Führe folgenden Befehl aus:
lsusb
  1. Suche nach einem Eintrag mit BitBox oder nach dieser Vendor- und Product-ID:
03eb:2403

Wenn die Ausgabe 03eb:2403 enthält, erkennt Linux deine BitBox.

Der Befehl lsusb prüft nur, ob Linux das Gerät auf USB-Ebene erkennt. Er bestätigt nicht, dass die BitBoxApp auch die nötigen Berechtigungen hat, um mit der BitBox zu kommunizieren.

 

Wenn Linux die BitBox nicht erkennt

Wenn lsusb weder 03eb:2403 noch einen BitBox-bezogenen Eintrag anzeigt, erkennt Linux das Gerät aktuell nicht.

Wiederhole in diesem Fall die grundlegenden Verbindungsprüfungen sorgfältig:

  1. Verwende ein anderes USB-Kabel.
  2. Entferne USB-Hubs, Docks, Adapter oder Verlängerungskabel.
  3. Verwende einen anderen USB-Anschluss.
  4. Starte deinen Computer neu.
  5. Teste die BitBox nach Möglichkeit an einem anderen Computer oder Android-Smartphone.

Wenn die BitBox auf keinem Gerät erkannt wird, kontaktiere den Support und beschreibe, welche Schritte du bereits ausprobiert hast.


Wenn Linux die BitBox erkennt, aber die BitBoxApp nicht

Wenn lsusb den Eintrag 03eb:2403 anzeigt, erkennt Linux deine BitBox. Wenn die BitBoxApp sie trotzdem nicht anzeigt, fehlen meistens die nötigen USB-Zugriffsrechte.

Unter Linux wird dies in der Regel durch die korrekten udev-Regeln gelöst.

Du hast zwei Möglichkeiten:

  • Empfohlen: Installiere die udev-Regeln mit dem offiziellen GitHub-Skript.
  • Manuell: Erstelle die udev-Regeln selbst.

Die folgenden Schritte ändern systemweite Linux-Einstellungen. Fahre nur fort, wenn du dich mit der Verwendung des Terminals wohlfühlst.

 

Empfohlen: udev-Regeln mit dem offiziellen Skript installieren

Diese Methode ist für die meisten Nutzer empfohlen, weil sie das Risiko manueller Fehler reduziert.

Das Skript:

  • installiert die richtigen udev-Regeln,
  • verwendet die offiziellen Dateinamen und Regeldefinitionen,
  • entspricht der Einrichtung, die auch von Distributionspaketen verwendet wird,
  • und ist einfacher zu warten als eine manuelle Einrichtung.

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

frontends/qt/resources/deb-afterinstall.sh

Nachdem du das Skript ausgeführt hast:

  1. Trenne deine BitBox vom Computer.
  2. Verbinde deine BitBox erneut.
  3. Starte die BitBoxApp neu.
  4. Melde dich ab und wieder an oder starte deinen Computer neu, falls nötig.

Diese Methode ist für die meisten Linux-Nutzer die beste Wahl. Sie ist einfacher zu pflegen und weniger fehleranfällig als das manuelle Erstellen der udev-Regeln.

 

Manuell: udev-Regeln selbst installieren

Verwende diese Methode nur, wenn du volle Kontrolle bevorzugst oder das offizielle Skript nicht ausführen kannst.

  1. Öffne ein Terminal.
  2. Erstelle die erste udev-Regel:
sudo tee /etc/udev/rules.d/53-hid-BitBox.rules > /dev/null <<EOF
SUBSYSTEM=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl"
EOF
  1. Erstelle die zweite udev-Regel:
sudo tee /etc/udev/rules.d/54-hidraw-BitBox.rules > /dev/null <<EOF
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl"
EOF
  1. Lade die udev-Regeln neu:
sudo udevadm control --reload
  1. Wende die udev-Regeln an:
sudo udevadm trigger
  1. Trenne deine BitBox vom Computer.
  2. Verbinde deine BitBox erneut.
  3. Starte die BitBoxApp neu.

Wenn die BitBox weiterhin nicht in der BitBoxApp erkannt wird

Auf manchen Linux-Distributionen können zusätzliche Gruppenberechtigungen erforderlich sein.

  1. Füge deinen Nutzer zur Gruppe plugdev hinzu:
sudo usermod -aG plugdev $USER
  1. Melde dich ab und wieder an oder starte deinen Computer neu.
  2. Verbinde deine BitBox erneut.
  3. Starte die BitBoxApp neu.

Änderungen an Gruppenberechtigungen werden erst wirksam, nachdem du dich ab- und wieder angemeldet hast oder den Computer neu gestartet hast.

 

Prüfe, ob andere Software die Verbindung blockiert

Manche Programme können die USB-Erkennung oder die Kommunikation mit USB-Geräten stören. Dazu gehören zum Beispiel:

  • Sicherheitssoftware,
  • Firewall-Tools,
  • Endpoint-Security-Software,
  • Virtualisierungssoftware,
  • Remote-Desktop-Tools,
  • Geräteverwaltungssoftware in Unternehmen,
  • oder andere Software, die den USB-Zugriff kontrolliert.

Wenn du einen Arbeitscomputer verwendest, kann der USB-Zugriff durch deine Organisation eingeschränkt sein.

Teste deine BitBox in diesem Fall nach Möglichkeit an einem privaten Computer.


Wenn das Problem weiterhin besteht

Wenn deine BitBox nach allen Schritten weiterhin nicht erkannt wird, hilft dir unser Support-Team gerne weiter.

Bitte sende uns folgende Informationen:

  • deine Linux-Distribution und Version,
  • die verwendete Version der BitBoxApp,
  • ob lsusb den Eintrag 03eb:2403 anzeigt,
  • ob du die udev-Regeln per Skript oder manuell installiert hast,
  • ob du dich ab- und wieder angemeldet oder den Computer neu gestartet hast,
  • welche Schritte du bereits ausprobiert hast,
  • und deine BitBoxApp-Logdateien.

Wie du die benötigten Dateien exportierst, erfährst du hier:
BitBoxApp-Supportdateien (Logdateien) finden und exportieren 

Kontaktiere anschließend den BitBox Support und sende uns die oben genannten Informationen.

Wenn du an diesem Punkt angekommen bist, hast du die wichtigsten Linux-Schritte bereits durchgeführt. Diese Informationen helfen dem Support, das Problem gezielter zu untersuchen.

 

FAQ – Häufig gestellte Fragen

Ist meine BitBox defekt, wenn sie auf Linux nicht erkannt wird?

In den meisten Fällen nicht. USB-Verbindungsprobleme entstehen meist durch Kabel, USB-Anschlüsse, Adapter, fehlende udev-Regeln, Berechtigungen oder die Linux-Systemkonfiguration.


Warum erkennt Linux meine BitBox, aber die BitBoxApp nicht?

Wenn lsusb den Eintrag 03eb:2403 anzeigt, erkennt Linux die BitBox auf USB-Ebene. Wenn die BitBoxApp sie trotzdem nicht anzeigt, fehlen meistens die nötigen USB-Zugriffsrechte.


Was sind udev-Regeln?

udev-Regeln sind Linux-Systemregeln, die festlegen, wie angeschlossene Geräte behandelt werden. Für die BitBox erlauben sie der BitBoxApp, über USB mit dem Gerät zu kommunizieren.


Was bedeutet 03eb:2403?

03eb:2403 ist die USB Vendor- und Product-ID, mit der die BitBox identifiziert wird. Wenn lsusb diesen Wert anzeigt, erkennt Linux deine BitBox.


Muss ich nach dem Installieren der udev-Regeln neu starten?

Oft reicht es, die BitBox zu trennen, erneut zu verbinden und die BitBoxApp neu zu starten. Wenn die BitBox weiterhin nicht erkannt wird, melde dich ab und wieder an oder starte deinen Computer neu.


Kann ich durch ein USB-Verbindungsproblem meine Coins verlieren?

Nein. Deine Coins sind nicht auf der BitBox gespeichert, sondern auf der Blockchain verzeichnet. Solange deine Wiederherstellungswörter sicher gesichert sind, sind deine Guthaben durch ein USB-Verbindungsproblem nicht gefährdet.


Wann sollte ich den Support kontaktieren?

Kontaktiere den Support, wenn du verschiedene Kabel, USB-Anschlüsse und Geräte getestet, lsusb geprüft, die udev-Regeln installiert und deine Sitzung oder deinen Computer neu gestartet hast, das Problem aber weiterhin besteht.