La BitBoxApp AppImage te permite usar la BitBoxApp en Linux sin necesidad de instalar paquetes a nivel del sistema. En esta guía aprenderás cómo hacer que el archivo AppImage sea ejecutable y cómo iniciar la aplicación, ya sea mediante el gestor de archivos gráfico (recomendado) o a través de la terminal.


Requisitos previos

Antes de continuar, asegúrate de que:


Hacer que el AppImage sea ejecutable

Linux no permite ejecutar archivos descargados de forma predeterminada. Puedes habilitar el permiso de ejecución de una de las siguientes maneras.

Opción A (recomendada): Usando el gestor de archivos (sin terminal)

Este es el método más sencillo para la mayoría de los usuarios.

  1. Abre tu gestor de archivos y navega hasta la carpeta donde se encuentra el archivo AppImage descargado (por ejemplo, Descargas).
  2. Haz clic con el botón derecho sobre el archivo BitBoxApp AppImage.
  3. Selecciona Propiedades.
  4. Abre la pestaña Permisos o Derechos de acceso.
  5. Activa la opción Permitir ejecutar el archivo como un programa.
  6. Cierra la ventana de propiedades.

El archivo AppImage ya es ejecutable.


Opción B: Usando la terminal (para usuarios avanzados)

Si prefieres usar la terminal o trabajas con un entorno de escritorio mínimo:

  1. Abre una terminal.
  2. Ve a la carpeta donde se encuentra el archivo AppImage, por ejemplo:
    cd ~/Descargas
  3. Haz que el archivo sea ejecutable:
    chmod +x BitBox-[version]-x86_64.AppImage

Sustituye [version] por el número de versión real del archivo descargado.


Iniciar la BitBoxApp

Ahora puedes iniciar la BitBoxApp.

  • Desde el gestor de archivos: haz doble clic en el archivo AppImage.
  • Desde la terminal:
    ./BitBox-[version]-x86_64.AppImage

La BitBoxApp debería iniciarse y guiarte en la conexión y el uso de tu BitBox02.


Descargar mediante curl (opcional)

Si la descarga mediante el navegador no funciona, puedes usar curl:

curl -O https://github.com/digitalbitbox/bitbox-wallet-app/releases/download/v[version]/BitBox-[version]-x86_64.AppImage

Sustituye [version] por la versión deseada.

Si descargas a través de Tor, configura curl en consecuencia (por ejemplo, usando un proxy SOCKS5).


Preguntas frecuentes (FAQ)

¿Necesito instalar la BitBoxApp a nivel del sistema?

No. El archivo AppImage se ejecuta de forma independiente y no requiere una instalación a nivel del sistema.

¿La AppImage se actualiza automáticamente?

No. Para actualizar la BitBoxApp, descarga la versión más reciente del AppImage y sustituye el archivo existente.

¿Por qué debo hacer que el archivo sea ejecutable?

Por razones de seguridad, Linux desactiva por defecto la ejecución de archivos descargados. Esto evita que programas desconocidos se ejecuten accidentalmente.

La BitBoxApp no detecta mi BitBox02. ¿Qué puedo hacer?

Si tu BitBox02 no es reconocida, normalmente se debe a permisos USB o a configuraciones específicas del sistema. Sigue la guía de solución de problemas dedicada, que incluye todos los pasos necesarios para las distribuciones de Linux compatibles:
La BitBox02 no se reconoce por USB – Solución de problemas en macOS, Windows y Linux 

¿Cómo puedo verificar la suma de comprobación (checksum) de la BitBoxApp?

Verificar la suma de comprobación garantiza que el archivo AppImage se haya descargado correctamente y no haya sido modificado. Encontrarás una guía paso a paso aquí:
Cómo verificar la suma de comprobación de BitBoxApp (SHA-256)