Si la BitBoxApp no se instala o no se abre en Linux, empieza por el mensaje de error que aparece. Un fallo del gestor de paquetes, una AppImage que no arranca y una aplicación que se cierra nada más abrirse requieren comprobaciones distintas.

Elige el apartado que corresponda a tu problema:

• La descarga está incompleta o no sabes qué archivo utilizar
• Un paquete DEB o RPM no se instala
• La AppImage no arranca
• El software de seguridad o una política del equipo bloquea el archivo
• La BitBoxApp está instalada, pero no se abre

Comprobar la descarga y el tipo de paquete

Comprueba que el archivo procede de la página oficial de descarga de BitBoxApp y que la descarga ha terminado. Si se interrumpió, elimina el archivo incompleto y descárgalo de nuevo. Si el navegador o el software de seguridad detecta una amenaza, consulta primero el apartado sobre bloqueos de seguridad antes de volver a intentarlo.

El archivo debe corresponder a tu sistema Linux. Las descargas oficiales para Linux están destinadas a ordenadores con arquitectura x86-64, también llamada amd64. Un ordenador ARM de 64 bits necesita una compilación distinta. Antes de continuar, consulta los sistemas operativos compatibles, especialmente si tu distribución o versión no figura en la lista.

• DEB: utiliza el paquete .deb para Debian o Ubuntu.
• RPM: utiliza el paquete .rpm para Fedora u openSUSE.
• AppImage: utiliza el archivo .AppImage para ejecutar la aplicación sin instalar un paquete para todo el sistema. Aun así, necesitas un entorno Linux compatible.

Encontrarás los pasos habituales en Instalar la BitBoxApp en Linux o Ejecutar la BitBoxApp AppImage en Linux. Elegir una AppImage no garantiza que funcione en un sistema no compatible.

Antes de ejecutar el archivo, puedes comprobar su suma de comprobación o verificar su firma. Si la verificación falla, no abras ni instales ese archivo y contacta con el soporte de BitBox.

Si no se instala un paquete DEB o RPM

Abre el paquete adecuado con el gestor de paquetes de tu sistema. Si la instalación falla, anota el mensaje de error completo: te ayudará a elegir el siguiente paso.

• Formato de paquete o arquitectura incorrectos: revisa la descarga siguiendo el apartado anterior. No fuerces la instalación en un sistema incompatible.
• Se requieren permisos de administrador: autoriza la instalación mediante el diálogo habitual de autenticación del sistema solo si descargaste el archivo desde la página oficial. Si no tienes permiso para instalar software en un ordenador administrado por tu empresa o centro educativo, consulta con la persona responsable del equipo.
• Hay otra instalación o actualización en curso: espera a que termine y vuelve a intentar instalar el paquete de BitBoxApp. No elimines los archivos de bloqueo del gestor de paquetes.
• Falta una dependencia, hay un conflicto entre paquetes o aparece otro error: anota el mensaje completo y contacta con el soporte de BitBox. No fuerces la instalación ni elimines paquetes del sistema para sortear el error.

Cuando termine la instalación, abre la BitBoxApp desde el menú de aplicaciones. Si no se abre, continúa con las comprobaciones de inicio.

Si la AppImage no arranca

Una AppImage se ejecuta directamente desde el archivo descargado. Comprueba primero que el archivo oficial tiene permiso de ejecución:

1. En el gestor de archivos, haz clic con el botón derecho en la AppImage y selecciona Propiedades.
2. En Permisos o Derechos de acceso, activa la opción que permite ejecutar el archivo como un programa. Según el gestor de archivos, puede llamarse Permitir ejecutar el archivo como un programa o tener una etiqueta equivalente.
3. Cierra la ventana de propiedades y vuelve a abrir la AppImage con un doble clic.

Si esa opción no aparece, utiliza el método de la terminal descrito en la guía de AppImage. Si el archivo sigue sin abrirse, ejecutarlo desde la terminal puede mostrar el error:

1. Abre una terminal en la carpeta que contiene la AppImage descargada.
2. Introduce el siguiente comando y sustituye VERSION por el número de versión que aparece en el nombre del archivo. Conserva las comillas y el ./ inicial.

./"BitBox-VERSION-x86_64.AppImage"

Si la BitBoxApp se abre, el problema de inicio está resuelto. Si la terminal muestra un error de FUSE, consulta el siguiente apartado. Si aparece otro error o sigue sin abrirse ninguna ventana, guarda la salida de la terminal y contacta con soporte.

Si el error menciona FUSE o libfuse.so.2

Un mensaje como AppImages require FUSE to run o un aviso de que falta libfuse.so.2 apunta a un problema con la biblioteca FUSE. FUSE permite a Linux acceder al contenido de la AppImage; dar permiso de ejecución al archivo no soluciona la falta de esa biblioteca.

Si falta la biblioteca FUSE 2 en Ubuntu, instala desde los repositorios habituales el paquete correspondiente a tu versión exacta:

• Ubuntu 22.04: sudo apt install libfuse2
• Ubuntu 24.04: sudo apt install libfuse2t64

Revisa los cambios que propone el gestor de paquetes antes de confirmarlos. Si propone eliminar paquetes del sistema, detente. No sustituyas ni elimines FUSE 3. Para otra distribución o versión de Ubuntu, consulta la documentación de AppImage sobre problemas con FUSE (en inglés) o pregunta a la persona responsable del equipo qué paquete corresponde.

Una vez instalada la biblioteca, vuelve a ejecutar la misma AppImage. Si el error persiste o aparece uno distinto, envía el nuevo mensaje a soporte en lugar de repetir la instalación.

Si el software de seguridad o una política bloquea la aplicación

Si el navegador o una herramienta de seguridad detecta una amenaza, pone el archivo en cuarentena o impide ejecutarlo, anota el aviso exacto y el nombre de la amenaza, si aparece. No restaures ni autorices un archivo detectado como amenaza. Tampoco desactives la protección ni cambies de método de descarga para eludir el bloqueo. Contacta con el soporte de BitBox antes de ejecutarlo.

Si utilizas un ordenador administrado por tu empresa o centro educativo, pide a la persona responsable que revise las restricciones de instalación o ejecución. Una AppImage no sirve para eludir las políticas del equipo.

Si la BitBoxApp instalada no se abre

Este apartado se aplica si el gestor de paquetes confirma que la instalación ha terminado, pero no aparece ninguna ventana o la aplicación se cierra inmediatamente. Resuelve primero cualquier aviso de seguridad.

1. Cierra las ventanas de BitBoxApp que estén abiertas y vuelve a intentar abrir la aplicación.
2. Si sigue sin abrirse, abre una terminal e introduce BitBox. Respeta las mayúsculas y minúsculas: este es el comando de inicio de los paquetes DEB y RPM oficiales.
3. Guarda cualquier mensaje de error. Si la aplicación sigue sin abrirse o la terminal indica que no encuentra el comando, contacta con soporte e incluye ese resultado.

Ejecuta la aplicación con tu cuenta de usuario habitual. No utilices privilegios de administrador para sortear un error de inicio, ni borres datos de BitBoxApp o restablezcas tu BitBox para resolverlo.

Cuando la BitBoxApp se abra

El problema de instalación o inicio está resuelto cuando la BitBoxApp se abre con normalidad.

• Si muestra una versión antigua, sigue la guía para actualizar la BitBoxApp. No necesitas desinstalar la aplicación como primer paso.
• Si la aplicación se abre, pero no detecta tu BitBox, consulta la guía de problemas de conexión USB en Linux, que trata los permisos USB y las reglas udev.

Contactar con el soporte de BitBox

Contacta con el soporte de BitBox si las comprobaciones de tu apartado no resuelven el error, una dependencia o un conflicto entre paquetes impide la instalación, o queda pendiente aclarar una detección de seguridad. Si el equipo está administrado por una empresa o centro educativo, informa también a la persona responsable.

Incluye estos datos para que el equipo de soporte pueda reproducir el problema:

• tu distribución de Linux, su versión y la arquitectura del procesador, si la conoces;
• el nombre completo del archivo descargado y el formato utilizado: DEB, RPM o AppImage;
• si falla la instalación o si la aplicación no se abre una vez instalada;
• el mensaje de error exacto, el nombre de la amenaza detectada o la salida relevante de la terminal;
• si el ordenador es personal o está administrado por una empresa o centro educativo;
• si utilizas Wayland o X11, en caso de que lo sepas; y
• las comprobaciones que ya has realizado.

Comparte solo el error relevante o una captura de pantalla recortada y elimina los datos personales. Nunca envíes palabras de recuperación, una copia de seguridad de tu billetera, contraseñas, passphrases, claves privadas ni códigos de autenticación.