Instala BitBoxBridge si la guía de conexión de tu billetera web lo requiere. Es una aplicación que se ejecuta en segundo plano en Windows, macOS y Linux para permitir conexiones compatibles desde el navegador. No la necesitas para usar la BitBoxApp normalmente.
Después de la instalación, BitBoxBridge se inicia automáticamente y sigue funcionando en segundo plano, también cuando reinicias el ordenador. Normalmente no tienes que abrirla. Los pasos siguientes te permiten instalarla y comprobar primero si puedes acceder a ella desde el propio ordenador, antes de conectar tu billetera.
1. Descarga BitBoxBridge
- En el ordenador donde vayas a utilizar la billetera web, abre la página oficial de descargas de BitBox. Baja hasta el apartado Descargar BitBox Bridge, situado debajo de las descargas de la BitBoxApp.
- Elige la descarga para tu sistema operativo. En Linux, abre la selección de distribuciones y elige el paquete
.debpara Ubuntu o Debian, o el paquete.rpmpara Fedora u openSUSE. Esta guía describe la instalación mediante esos paquetes, no la instalación manual desde un archivo comprimido.

Utiliza la versión que se ofrece para tu sistema operativo. Windows, macOS y Linux no siempre tienen el mismo número de versión. También puedes encontrar las versiones publicadas en el repositorio oficial de BitBoxBridge en GitHub, si prefieres esta opción avanzada.
Descarga solo desde fuentes oficiales
Descarga BitBoxBridge únicamente desde la web oficial de BitBox o el repositorio de BitBoxSwiss en GitHub. Si el sistema operativo muestra una advertencia de seguridad que no entiendes, detén el proceso y contacta con soporte antes de ignorarla o desactivar las protecciones.
Opcional: comprueba la descarga antes de instalar
Una suma de comprobación SHA-256 permite comparar el archivo descargado con el que indica BitBox. En la página de descargas, selecciona Mostrar sumas de comprobación dentro del apartado de BitBox Bridge, no en el apartado independiente de la BitBoxApp.
- Busca la suma que corresponde exactamente al archivo y al sistema operativo que has elegido.
- Calcula la suma SHA-256 del archivo descargado. En Windows, abre PowerShell; en macOS o Linux, abre Terminal. Utiliza el comando correspondiente que aparece debajo y sustituye la ruta de ejemplo entre comillas por la ruta completa de tu archivo. Comprueba el archivo original descargado antes de descomprimirlo o instalarlo.
Windows:
Get-FileHash -Algorithm SHA256 -LiteralPath "C:\path\to\downloaded-file.exe"macOS:
shasum -a 256 "/path/to/downloaded-file.pkg"Linux:
sha256sum "/path/to/downloaded-file.deb"Si has descargado un paquete RPM, utiliza el nombre real del archivo con la extensión .rpm.
- Compara el valor hash completo que has calculado con la suma indicada en la página oficial. No importa si las letras aparecen en mayúsculas o minúsculas. Si los valores no coinciden, no ejecutes el archivo. Vuelve a descargarlo desde la fuente oficial y, si la diferencia persiste, contacta con soporte.
2. Instala el archivo descargado
Es posible que necesites permisos de administrador. Sigue los pasos de tu sistema operativo y mantén activadas las protecciones del ordenador.
Windows
- Abre la carpeta Descargas, o la ubicación donde hayas guardado el archivo, y haz doble clic en el instalador
.exede BitBoxBridge. - Sigue las instrucciones de instalación. Si Windows solicita permiso de administrador, concédelo solo para la instalación que has iniciado con el archivo descargado de la fuente oficial. Espera a que termine.
macOS
- En el Finder, abre la carpeta que contiene el archivo
.pkgde BitBoxBridge y haz doble clic en él. - Sigue los pasos del instalador hasta el final. Si macOS lo solicita, introduce la contraseña de administrador del Mac en el cuadro de diálogo del sistema. Es la contraseña del ordenador, no la contraseña de tu BitBox.
Ubuntu, Debian, Fedora y openSUSE
- Abre la carpeta que contiene el archivo
.debo.rpmdescargado y ábrelo con el instalador de paquetes de tu distribución. - Selecciona la acción de instalar, autorízala si se solicita y espera a que el gestor de paquetes confirme que ha terminado. Si el sistema no ofrece un instalador adecuado o muestra un error, detén el proceso y contacta con soporte. Indica la distribución y el texto exacto del error.
El instalador inicia BitBoxBridge como servicio en segundo plano. Es normal que no se abra una ventana de la aplicación. A continuación, comprueba si puedes acceder al servicio.
3. Comprueba si BitBoxBridge está en ejecución
- Abre un navegador en el mismo ordenador e introduce http://127.0.0.1:8178/ en la barra de direcciones. Esta dirección corresponde a tu propio ordenador. También puedes utilizar http://localhost:8178/.
- Debería aparecer una página de estado sencilla que empieza por BitBoxBridge v, seguido de un número de versión. Incluye entradas como
GET /api/infoyGET /api/v1/devices. El ejemplo siguiente muestra la versión 1.6.0; la tuya puede ser distinta.

Esta respuesta confirma que BitBoxBridge está en ejecución y que puedes acceder a ella desde el navegador. No necesitas conectar la BitBox para hacer esta comprobación. La página todavía no confirma que una billetera web pueda detectar o utilizar el dispositivo.
Si la página no carga, reinicia el ordenador una vez y vuelve a abrir la dirección. Si sigue sin cargar, contacta con soporte e indica el sistema operativo, el nombre del archivo descargado y cualquier error de instalación o del navegador. No restablezcas tu BitBox ni restaures una copia de seguridad para resolver un problema de instalación de BitBoxBridge.
Conecta tu billetera web
Cuando la página de estado responda, vuelve a la guía de conexión de la billetera web que quieras utilizar. Cierra la BitBoxApp y las demás aplicaciones de billetera que puedan estar usando el dispositivo. Después, sigue el procedimiento de conexión de una billetera de hardware y conecta y desbloquea tu BitBox cuando se te indique.
No introduzcas datos secretos de la billetera en una web
Nunca introduzcas palabras de recuperación, una clave privada, la contraseña de tu BitBox ni una passphrase opcional en una billetera web. Tampoco subas una copia de seguridad de la billetera. Introduce la contraseña del dispositivo y la passphrase únicamente en la BitBox. Si una web solicita datos secretos de la billetera, detén el proceso y ciérrala.
Si la página de estado funciona, pero la billetera no se conecta, conserva de momento la instalación que funciona. Investiga la conexión entre el dispositivo, el navegador y la billetera antes de reinstalar. Para errores habituales, consulta la guía para solucionar problemas de conexión con BitBoxBridge. Si aparece una advertencia de seguridad o no sabes cómo continuar, contacta con el soporte de BitBox.
Si la instalación se interrumpió o soporte recomienda una reinstalación limpia, sigue primero Desinstalar BitBoxBridge. Después, vuelve a esta guía para instalar el paquete oficial y repetir la comprobación de la página de estado local. No necesitas restablecer la BitBox ni acceder a su copia de seguridad para reinstalar BitBoxBridge.