Si la BitBoxApp no detecta tu BitBox en Linux, el problema suele estar relacionado con los permisos de acceso USB.
Linux puede reconocer correctamente la BitBox como dispositivo USB, pero la BitBoxApp puede no tener permiso para comunicarse con ella. Esto ocurre normalmente cuando faltan las reglas udev necesarias.
En esta guía comprobarás primero si Linux detecta tu BitBox. Después aprenderás cómo instalar las reglas udev necesarias.
Antes de empezar
Antes de revisar la conexión USB, asegúrate de que:
- estás usando la última versión de la BitBoxApp, y
- el firmware de tu BitBox está actualizado.
Una versión antigua de la BitBoxApp o del firmware puede impedir que la BitBox se detecte correctamente, incluso si Linux reconoce el dispositivo USB.
Comprobaciones rápidas
Empieza con estas comprobaciones básicas antes de cambiar permisos o configuraciones del sistema en Linux.
- Prueba con otro cable USB.
- Conecta la BitBox directamente al ordenador.
- Evita usar hubs USB, estaciones de acoplamiento, adaptadores o cables de extensión durante la comprobación.
- Prueba con otro puerto USB.
- Conecta la BitBox con la pantalla orientada hacia arriba.
- Reinicia el ordenador.
- Si es posible, prueba la BitBox en otro ordenador o en un smartphone Android.
Si la BitBox funciona en otro dispositivo, lo más probable es que la BitBox esté funcionando correctamente. En ese caso, el problema probablemente esté relacionado con tu sistema Linux, los permisos USB, la configuración de tu distribución o algún software del sistema.
Comprueba si Linux detecta tu BitBox
Primero comprueba si Linux reconoce tu BitBox como dispositivo USB conectado.
- Conecta tu BitBox al ordenador Linux.
- Abre una terminal.
- Ejecuta este comando:
lsusb- Busca una entrada que contenga BitBox o el siguiente ID de fabricante y producto:
03eb:2403Si la salida muestra 03eb:2403, Linux detecta tu BitBox.
El comando lsusb solo comprueba si Linux detecta el dispositivo a nivel USB. No confirma que la BitBoxApp tenga permiso para comunicarse con la BitBox.
Si Linux no detecta la BitBox
Si lsusb no muestra 03eb:2403 ni ninguna entrada relacionada con BitBox, Linux no está detectando el dispositivo en este momento.
En este caso, repite cuidadosamente las comprobaciones físicas de conexión:
- Usa otro cable USB.
- Retira cualquier hub USB, dock, adaptador o cable de extensión.
- Prueba con otro puerto USB.
- Reinicia el ordenador.
- Si es posible, prueba la BitBox en otro ordenador o en un smartphone Android.
Si la BitBox no se detecta en ningún dispositivo, contacta con el soporte e incluye los pasos que ya has probado.
Si Linux detecta la BitBox, pero la BitBoxApp no
Si lsusb muestra 03eb:2403, Linux detecta la BitBox. Si la BitBoxApp sigue sin mostrarla, el problema suele estar relacionado con la falta de permisos de acceso USB.
En Linux, esto normalmente se soluciona instalando las reglas udev correctas.
Tienes dos opciones:
- Recomendada: instalar las reglas con el script oficial de GitHub.
- Manual: crear las reglas udev tú mismo.
Los siguientes pasos modifican la configuración del sistema Linux. Continúa solo si te sientes cómodo usando la terminal.
Opción recomendada: instalar las reglas udev con el script oficial
Este método es el recomendado para la mayoría de los usuarios, porque reduce el riesgo de errores manuales.
El script:
- instala las reglas udev correctas,
- usa los nombres de archivo y definiciones oficiales,
- coincide con la configuración usada por los paquetes de distribución,
- y es más fácil de mantener que una configuración manual.
Descarga y ejecuta el script oficial de reglas udev desde el repositorio de BitBox en GitHub:
→ frontends/qt/resources/deb-afterinstall.sh
Después de ejecutar el script:
- Desconecta tu BitBox.
- Vuelve a conectar tu BitBox.
- Reinicia la BitBoxApp.
- Cierra sesión y vuelve a iniciarla, o reinicia el ordenador si es necesario.
Este es el método recomendado para la mayoría de los usuarios de Linux. Es más fácil de mantener y menos propenso a errores que crear las reglas udev manualmente.
Opción manual: instalar las reglas udev tú mismo
Usa este método solo si prefieres tener control total o si no puedes ejecutar el script oficial.
- Abre una terminal.
- Crea la primera regla udev:
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- Crea la segunda regla udev:
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- Recarga las reglas udev:
sudo udevadm control --reload- Aplica las reglas udev:
sudo udevadm trigger- Desconecta tu BitBox.
- Vuelve a conectar tu BitBox.
- Reinicia la BitBoxApp.
Si la BitBox sigue sin aparecer en la BitBoxApp
En algunas distribuciones de Linux pueden ser necesarios permisos de grupo adicionales.
-
Añade tu usuario al grupo
plugdev:
sudo usermod -aG plugdev $USER- Cierra sesión y vuelve a iniciarla, o reinicia el ordenador.
- Vuelve a conectar tu BitBox.
- Reinicia la BitBoxApp.
Los cambios de grupo solo se aplican después de cerrar sesión y volver a iniciarla, o después de reiniciar el ordenador.
Comprueba si otro software bloquea la conexión
Algunos programas pueden interferir con la detección USB o con la comunicación con dispositivos USB. Esto puede incluir:
- software de seguridad,
- herramientas de firewall,
- software de seguridad endpoint,
- herramientas de virtualización,
- herramientas de escritorio remoto,
- software de gestión de dispositivos de empresa,
- u otro software que controle el acceso USB.
Si usas un ordenador gestionado por tu trabajo, es posible que tu organización limite el acceso USB.
En ese caso, prueba tu BitBox en un ordenador personal si es posible.
Si el problema continúa
Si tu BitBox sigue sin ser reconocida después de completar los pasos anteriores, nuestro equipo de soporte estará encantado de ayudarte.
Incluye la siguiente información:
- tu distribución de Linux y versión,
- la versión de la BitBoxApp que estás usando,
-
si
lsusbmuestra03eb:2403, - si instalaste las reglas udev con el script o manualmente,
- si cerraste sesión y volviste a iniciarla o reiniciaste el ordenador,
- qué pasos ya has probado,
- y tus archivos de registro de la BitBoxApp.
Puedes seguir esta guía para exportar los archivos necesarios:
→ Cómo localizar y exportar los archivos de soporte de BitBoxApp
Después, contacta con el soporte e incluye la información anterior.
Si has llegado hasta este punto, ya has completado los pasos estándar de solución de problemas en Linux. Esta información ayuda al soporte a investigar el caso de forma más específica.
FAQ – Preguntas frecuentes
¿Mi BitBox está defectuosa si no se reconoce en Linux?
En la mayoría de los casos, no. Los problemas de conexión USB suelen deberse a cables, puertos USB, adaptadores, reglas udev faltantes, permisos o la configuración del sistema Linux.
¿Por qué Linux detecta mi BitBox, pero la BitBoxApp no?
Si lsusb muestra 03eb:2403, Linux detecta la BitBox a nivel USB. Si la BitBoxApp sigue sin mostrarla, normalmente faltan los permisos de acceso USB necesarios.
¿Qué son las reglas udev?
Las reglas udev son reglas del sistema Linux que definen cómo se gestionan los dispositivos conectados. Para la BitBox, permiten que la BitBoxApp se comunique con el dispositivo por USB.
¿Qué significa 03eb:2403?
03eb:2403 es el ID USB de fabricante y producto que identifica la BitBox. Si lsusb muestra este valor, Linux detecta tu BitBox.
¿Tengo que reiniciar después de instalar las reglas udev?
Normalmente basta con desconectar y volver a conectar la BitBox y reiniciar la BitBoxApp. Si la BitBox sigue sin detectarse, cierra sesión y vuelve a iniciarla, o reinicia el ordenador.
¿Puedo perder mis monedas por un problema de conexión USB?
No. Tus monedas no están almacenadas en la BitBox, sino registradas en la blockchain. Mientras tus palabras de recuperación estén guardadas de forma segura, tus fondos no están en riesgo por un problema de conexión USB.
¿Cuándo debería contactar con el soporte?
Contacta con el soporte si ya has probado distintos cables, puertos USB y dispositivos, comprobaste lsusb, instalaste las reglas udev, reiniciaste tu sesión o el ordenador, y el problema continúa.