Si la BitBoxApp no se instala o no se inicia correctamente en Linux, el problema suele deberse a una distribución de Linux no compatible, una descarga incompleta, permisos de ejecución faltantes, restricciones del gestor de paquetes, permisos de administrador insuficientes o software de seguridad que bloquea la app.

Completa primero las comprobaciones básicas y, después, consulta la sección que corresponda a tu método de instalación en Linux o al comportamiento que observas.

Antes de comenzar

1. Comprueba si tu distribución de Linux es compatible. Las distribuciones o versiones del sistema operativo no compatibles pueden impedir que la BitBoxApp se instale o se abra correctamente. Consulta la lista de dispositivos y sistemas operativos compatibles con la BitBoxApp para confirmar que tu distribución de Linux es compatible.
2. Actualiza Linux. Instala las actualizaciones del sistema operativo más recientes disponibles para tu distribución. Esto ayuda a mantener la compatibilidad con la última versión de BitBoxApp y permite que las funciones de seguridad y los gestores de paquetes actúen correctamente.
3. Reinicia tu ordenador. Reiniciar Linux puede solucionar problemas temporales de inicio, liberar archivos o bloqueos del gestor de paquetes y completar procesos de actualización pendientes.

Solución de problemas

Descargar un archivo nuevo de BitBoxApp

Una descarga incompleta o dañada puede impedir que el paquete o la AppImage de BitBoxApp se abran correctamente.

1. Elimina de la carpeta Descargas el paquete o la AppImage de BitBoxApp que hayas descargado. No instales ni ejecutes el archivo si procede de una fuente no oficial.
2. Abre la página oficial de descarga de BitBox.
3. Descarga el archivo más reciente de BitBoxApp para tu método de instalación en Linux.
4. Usa el paquete .deb para distribuciones basadas en Debian.
5. Usa el paquete .rpm para distribuciones basadas en RPM.
6. Usa la AppImage si prefieres un archivo de app portátil o si tu distribución no usa paquetes DEB o RPM.

Si quieres comprobar la nueva descarga, puedes verificar la suma de comprobación de BitBoxApp. Los usuarios avanzados también pueden verificar la firma del paquete de BitBoxApp en Linux.

El archivo descargado debería abrirse con el método de instalación adecuado para tu distribución.

Comprobar la distribución de Linux y el tipo de paquete

El paquete de BitBoxApp para Linux debe coincidir con tu distribución de Linux.

1. Usa el paquete .deb en distribuciones basadas en Debian como Debian, Ubuntu, Linux Mint, Pop!_OS y Zorin OS.
2. Usa el paquete .rpm en distribuciones basadas en RPM como Fedora, openSUSE y distribuciones compatibles con Red Hat Enterprise Linux.
3. Usa la AppImage si tu distribución de Linux no admite el formato oficial DEB o RPM.
4. Si descargaste el tipo de paquete equivocado, elimínalo y descarga el archivo correcto desde la página oficial de descarga de BitBox.
5. Si tu distribución no es compatible, usa una distribución compatible o prueba la AppImage cuando sea apropiado.

El archivo de BitBoxApp seleccionado debería coincidir con tu distribución y método de instalación en Linux.

Si falla un paquete DEB o RPM

La instalación del paquete puede fallar si el gestor de paquetes de Linux bloquea la instalación, faltan permisos de administrador, descargaste el tipo de paquete equivocado o tu sistema operativo no es compatible o está desactualizado.

1. Confirma que descargaste el paquete .deb o .rpm correcto para tu distribución.
2. Abre el paquete con el gestor de paquetes de tu sistema.
3. Aprueba la instalación si tu sistema Linux solicita confirmación.
4. Introduce tu contraseña de administrador si tu sistema Linux la solicita.
5. Espera hasta que el gestor de paquetes indique que la instalación se completó.
6. Abre la BitBoxApp desde el menú de aplicaciones.

Si el gestor de paquetes sigue mostrando un error, instala las actualizaciones disponibles del sistema operativo, descarga un paquete nuevo de BitBoxApp y repite la instalación. El gestor de paquetes debería completar la instalación y la BitBoxApp debería abrirse normalmente.

Si la AppImage no se inicia

Linux suele desactivar los permisos de ejecución para archivos descargados. Si la BitBoxApp AppImage no se inicia, primero haz que la AppImage sea ejecutable.

1. Abre tu gestor de archivos.
2. Ve a la carpeta que contiene la BitBoxApp AppImage descargada.
3. Haz clic con el botón derecho en el archivo AppImage.
4. Selecciona Propiedades.
5. Abre la pestaña Permisos o Derechos de acceso.
6. Activa Permitir ejecutar el archivo como un programa, si tu entorno de escritorio muestra esta opción.
7. Cierra la ventana de propiedades.
8. Haz doble clic de nuevo en la AppImage.

Si tu entorno de escritorio no muestra una opción de permisos de ejecución, sigue los pasos para ejecutar la BitBoxApp AppImage en Linux mediante la terminal.

La BitBoxApp AppImage debería iniciarse ahora.

Comprobar software de seguridad o políticas de dispositivos administrados

Antivirus, herramientas de protección de endpoints, ajustes de seguridad del navegador, políticas de empresa o permisos de usuario restringidos pueden bloquear la descarga, instalación o ejecución de BitBoxApp.

1. Comprueba si tu navegador bloqueó el archivo de BitBoxApp descargado.
2. Comprueba si el software de seguridad puso en cuarentena o bloqueó el paquete o la AppImage descargada.
3. Si usas un ordenador administrado del trabajo, de la escuela o de una empresa, pregunta al administrador del dispositivo si la instalación de software o la ejecución de AppImages está restringida.
4. Descarga de nuevo el archivo más reciente de BitBoxApp después de resolver el bloqueo.
5. Instala de nuevo el paquete o inicia de nuevo la AppImage.

La BitBoxApp debería poder instalarse o iniciarse.

Si la BitBoxApp no se abre después de la instalación

Si la BitBoxApp se cierra inmediatamente, no aparece ninguna ventana o no pasa nada después de la instalación, es posible que la instalación esté incompleta o que tu entorno Linux siga bloqueando la app.

1. Cierra la BitBoxApp si hay alguna ventana de BitBoxApp abierta.
2. Reinicia tu ordenador.
3. Abre de nuevo la BitBoxApp desde el menú de aplicaciones o inicia de nuevo la AppImage.
4. Si la BitBoxApp sigue sin abrirse, elimina el paquete de BitBoxApp instalado o borra el archivo AppImage.
5. Descarga de nuevo el archivo más reciente de BitBoxApp desde la página oficial de descarga de BitBox.
6. Instala de nuevo el paquete o haz que la AppImage vuelva a ser ejecutable.
7. Abre la BitBoxApp.

La BitBoxApp debería abrirse normalmente.

Si la BitBoxApp sigue mostrando una versión antigua

Instalar el paquete más reciente para Linux normalmente actualiza la instalación existente de BitBoxApp. La AppImage no se actualiza automáticamente y debe reemplazarse manualmente.

1. Abre la BitBoxApp.
2. Abre Ajustes → Acerca de.
3. Compara la versión de BitBoxApp mostrada con la última versión estable de BitBoxApp publicada en el repositorio oficial de GitHub.
4. Cierra la BitBoxApp por completo solo si las versiones no coinciden.
5. Elimina el paquete de BitBoxApp instalado o borra el archivo AppImage anterior.
6. Descarga el paquete de Linux o la AppImage más reciente desde la página oficial de descarga de BitBox.
7. Instala el paquete nuevo o inicia la nueva AppImage.
8. Abre Ajustes → Acerca de y vuelve a comparar la versión mostrada.

La versión que aparece en Ajustes → Acerca de debería coincidir con la última versión estable de BitBoxApp publicada en el repositorio oficial de GitHub. Si coincide, estás utilizando la versión instalada o descargada más reciente.

Si tu BitBox no se detecta después de la instalación

Si la BitBoxApp se abre pero no detecta tu BitBox, la instalación normalmente ya está completa. Sigue los pasos para solucionar problemas de conexión USB con tu BitBox en Linux.

Preguntas frecuentes

¿Por qué la AppImage no se inicia cuando hago doble clic?

Linux suele desactivar los permisos de ejecución para archivos descargados. Primero haz que la BitBoxApp AppImage sea ejecutable y después iníciala de nuevo. Para usar el gestor de archivos o la terminal, sigue los pasos para ejecutar la BitBoxApp AppImage en Linux.

¿Debo usar DEB, RPM o AppImage?

Usa el paquete .deb para distribuciones basadas en Debian y el paquete .rpm para distribuciones basadas en RPM. Usa la AppImage si prefieres un archivo de app portátil o si tu distribución no usa paquetes DEB o RPM. Para elegir el método correcto, sigue los pasos para instalar la BitBoxApp en Linux o ejecutar la BitBoxApp AppImage en Linux.

¿Necesito permisos de administrador para instalar la BitBoxApp en Linux?

Normalmente sí. Instalar un paquete DEB o RPM suele requerir permisos de administrador. La AppImage no requiere instalación mediante el gestor de paquetes, pero tu sistema puede requerir permisos para ejecutar archivos descargados.

¿Puede el software de seguridad impedir que se instale la BitBoxApp en Linux?

Sí. Antivirus, protección de endpoints, ajustes de seguridad del navegador, políticas de empresa o permisos de usuario restringidos pueden impedir que la BitBoxApp se descargue, se instale o se inicie.

¿La BitBoxApp es compatible con todas las distribuciones de Linux?

No. La BitBoxApp es compatible con distribuciones y versiones de sistema operativo seleccionadas. Consulta la lista de dispositivos y sistemas operativos compatibles con la BitBoxApp antes de solucionar problemas de instalación.

¿Reinstalar la BitBoxApp eliminará mis fondos?

No. Reinstalar la BitBoxApp no elimina tus fondos. Tus criptomonedas permanecen en sus respectivas blockchains, mientras que el acceso a ellas está protegido por tu BitBox02 y tu copia de seguridad de la billetera.

¿Por qué la BitBoxApp se abre pero no detecta mi BitBox?

Si la BitBoxApp se abre pero no detecta tu BitBox, la instalación normalmente ya está completa. Sigue los pasos para solucionar problemas de conexión USB con tu BitBox en Linux, incluyendo la detección USB, las reglas udev y los permisos.

¿Cuándo debo contactar con el soporte de BitBox?

Contacta con el soporte de BitBox mediante el formulario oficial de contacto de soporte si el paquete sigue sin instalarse, la AppImage no se inicia después de hacerla ejecutable, la BitBoxApp sigue sin abrirse tras reinstalarla o Linux continúa bloqueando un archivo descargado desde la página oficial de BitBox.

Incluye toda la información posible:

• tu distribución y versión de Linux.
• si tu sistema está completamente actualizado.
• tu método de instalación: .deb, .rpm o AppImage.
• si usas Wayland o X11, si lo sabes.
• si tu ordenador es un dispositivo personal o un dispositivo administrado del trabajo, de la escuela o de una empresa.
• la versión de BitBoxApp que intentaste instalar o ejecutar.
• el mensaje exacto del error del gestor de paquetes, permisos, seguridad o inicio.
• si tienes instalado software de seguridad o protección de endpoints.
• una captura de pantalla de la advertencia o del error, si es posible.

Esta información ayuda al soporte de BitBox a identificar la causa más rápidamente.