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.

Esta guía te ayuda a resolver problemas de instalación de BitBoxApp en Linux y abrir la BitBoxApp correctamente.

Esta guía aplica si

• el paquete .deb o .rpm descargado no se abre.
• tu gestor de paquetes muestra un error de instalación.
• tu sistema Linux solicita permisos y la instalación no continúa.
• la BitBoxApp AppImage no se inicia.
• no pasa nada cuando haces doble clic en la BitBoxApp AppImage.
• la BitBoxApp no se abre después de la instalación.
• la BitBoxApp sigue mostrando una versión anterior después de instalar la versión más reciente.

Antes de continuar

Antes de cambiar permisos de Linux o instalar de nuevo la BitBoxApp:

1. Elimina cualquier archivo de BitBoxApp que hayas descargado desde una fuente no oficial.
2. Consulta el artículo sobre dispositivos y sistemas operativos compatibles con la BitBoxApp para confirmar que tu distribución de Linux es compatible.
3. Instala las actualizaciones disponibles del sistema operativo si tu sistema Linux no se ha actualizado recientemente.
4. Reinicia tu ordenador si instalaste o actualizaste la BitBoxApp pero aún no reiniciaste Linux.

Si quieres verificar la descarga antes de continuar, usa la guía para verificar la suma de comprobación de BitBoxApp. Los usuarios avanzados también pueden usar la guía para verificar la firma de BitBoxApp en Linux.

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 el paquete o la AppImage de BitBoxApp descargado de tu carpeta de Descargas.
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.

El archivo descargado debería abrirse normalmente. Si el mismo problema continúa, sigue con la sección que corresponda a tu método de instalació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.

• Usa el paquete .deb en distribuciones basadas en Debian como Debian, Ubuntu, Linux Mint, Pop!_OS y Zorin OS.
• Usa el paquete .rpm en distribuciones basadas en RPM como Fedora, openSUSE y distribuciones compatibles con Red Hat Enterprise Linux.
• Usa la AppImage si tu distribución de Linux no admite el formato oficial DEB o RPM.

Si descargaste el tipo de paquete equivocado, elimínalo y descarga el archivo correcto desde la página oficial de descarga de BitBox.

Si tu distribución de Linux no es compatible, es posible que la BitBoxApp no se instale o no se inicie correctamente. En ese caso, usa una distribución compatible o prueba la versión AppImage.

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.

La BitBoxApp debería abrirse normalmente.

Si el gestor de paquetes sigue mostrando un error, instala las actualizaciones disponibles del sistema operativo, descarga un paquete nuevo de BitBoxApp e intenta la instalación de nuevo.

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.

La BitBoxApp AppImage debería iniciarse ahora.

Si tu entorno de escritorio no muestra una opción de permisos de ejecución, sigue la guía de BitBoxApp AppImage para Linux para usar el método con terminal.

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.

Para comprobar la versión instalada:

1. Abre la BitBoxApp.
2. Abre Ajustes.
3. Abre Acerca de.
4. Comprueba la versión de BitBoxApp que se muestra.

Si la versión antigua sigue apareciendo:

1. Cierra la BitBoxApp por completo.
2. Elimina el paquete de BitBoxApp instalado o borra el archivo AppImage anterior.
3. Descarga el paquete de Linux o la AppImage más reciente desde la página oficial de descarga de BitBox.
4. Instala el paquete nuevo o inicia la AppImage nueva.
5. Abre Ajustes.
6. Abre Acerca de.
7. Comprueba de nuevo la versión de BitBoxApp que se muestra.

La BitBoxApp debería mostrar ahora la versión recién instalada o recién descargada.

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

Esta guía se centra en instalar e iniciar la BitBoxApp en Linux. Si la BitBoxApp se abre pero no detecta tu BitBox, sigue la guía para solucionar problemas de conexión USB con tu BitBox en Linux.

Cuándo contactar con el soporte de BitBox

Si ninguno de los pasos anteriores resuelve el problema, contacta con el soporte de BitBox mediante nuestro formulario oficial de contacto de soporte.

• el paquete de BitBoxApp sigue sin instalarse.
• la BitBoxApp AppImage sigue sin iniciarse después de hacerla ejecutable.
• la BitBoxApp sigue sin abrirse después de reinstalarla o descargar un archivo nuevo.
• tu sistema Linux o software de seguridad sigue bloqueando la BitBoxApp después de confirmar que fue descargada desde la página oficial de descarga de BitBox.
• la BitBoxApp sigue mostrando una versión antigua después de reemplazarla o reinstalarla.

En tu solicitud, incluye si es posible la siguiente información:

• 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.
• cualquier mensaje de error del gestor de paquetes, permisos, seguridad o inicio.
• si tienes software de seguridad o protección de endpoints instalada.
• capturas de pantalla de la advertencia o el error, si es posible.

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

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. La guía de BitBoxApp AppImage para Linux explica tanto el método con el gestor de archivos como el método con terminal.

¿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. 

La guía para instalar la BitBoxApp en Linux explica cuándo usar el paquete de Linux, y la guía de BitBoxApp AppImage para Linux explica la opción portátil.

¿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 el artículo sobre 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 la guía para solucionar problemas de conexión USB con tu BitBox en Linux para comprobar la detección USB, las reglas udev y los permisos.