If the BitBoxApp on your computer does not detect your BitBox, please try the following:

1. Ensure that you have removed the screen protection sticker.
2. Ensure the BitBox02 is plugged in with the display pointing upwards. (The logo sticks out on that side).
3. Plug your BitBox02 in without an adapter or cable if possible.
4. Try using a different USB port.
5. Try using a different computer, or an Android phone.
6. When using the extension cable: Make sure the logo on the cable is on the same side as the BitBox02 display.

To check if your computer detects the BitBox at all:

1. Plug in BitBox02 and tap side to choose orientation
2. run ioreg -p IOUSB -l -w 0 | grep "Bit" in Terminal.
3. You should see an entry that includes “BitBox”.

Windows

1. Plug in BitBox02 and tap side to choose orientation
2. Open “Device Manager”.
3. Go to “Universal Serial Bus”.
4. Look for “USB composite device” (there could be multiple).
5. For each of the “USB composite devices”:
   1. right-click and select “Properties”.
   2. in the dropdown select “Hardware Ids”.
   3. if the ID contains “VID_03EB” and “PID_2403” it is a BitBox.

Linux

• printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox02_%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox02_%%n\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null
  printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"dbb%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/51-hid-digitalbitbox.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"dbbf%%n\"\n" | sudo tee /etc/udev/rules.d/52-hid-digitalbitbox.rules > /dev/null
  

• Or, if the above does not work for your distribution, add yourself to the ‘plugdev’ group (if not already a member; a reboot may be required for some distributions) and enter the following line in a terminal (sudo access required):

  printf "SUBSYSTEM==\"usb\", SYMLINK+=\"bitbox02_%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", SYMLINK+=\"bitbox02_%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null
  printf "SUBSYSTEM==\"usb\", SYMLINK+=\"dbb%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/51-hid-digitalbitbox.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", SYMLINK+=\"dbbf%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/52-hid-digitalbitbox.rules > /dev/null

sudo udevadm control --reload 
sudo udevadm trigger