---
title: El instalador no se ejecuta o falla la verificación
summary: Docker ausente, errores de permisos, fallos al lanzar el AppImage, conflictos de puerto, y problemas de verificación de firma, con la solución para cada uno.
date: 2026-09-10
---

# El instalador no se ejecuta o falla la verificación

Docker ausente, errores de permisos, fallos al lanzar el AppImage, conflictos de puerto, y problemas de verificación de firma, con la solución para cada uno.

## "Se requiere Docker pero no está instalado"

Instala Docker Engine (Linux) o Docker Desktop (macOS/Windows) desde docker.com, y luego verifica con `docker info` y `docker compose version`.

## "Permiso denegado" al ejecutar Docker en Linux

Tu usuario todavía no está en el grupo `docker`: `sudo usermod -aG docker $USER`, luego cierra sesión y vuelve a entrar, y confirma con `groups | grep docker`.

## El AppImage no se lanza en Ubuntu 22.04+

Instala la biblioteca de compatibilidad FUSE 2: `sudo apt install libfuse2t64` en Ubuntu 24.04+, o `sudo apt install libfuse2` en Ubuntu 22.04. Si prefieres no instalarla, ejecuta el AppImage con `--appimage-extract-and-run` en su lugar.

## Conflicto de puerto (9500, 9100, o similar ya en uso)

`install.sh` busca automáticamente un puerto libre, empezando desde el preferido e incrementando. Revisa `~/.heartbeatagents/.env` para ver qué puertos asignó realmente.

## La verificación de firma GPG falla

1. Confirma que importaste la clave pública correcta: `gpg --list-keys --fingerprint ops@mosaicsingularity.com`. Huella esperada: `3041 1399 8510 1531 C54B 0498 1009 78CA B0A0 5886`.
2. Si la huella no coincide, no confíes en el paquete. Alguien puede haber alterado la clave o el archivo.
3. Reporta cualquier manipulación sospechada a `ops@mosaicsingularity.com`.

## macOS dice que la aplicación "está dañada" o "no se puede abrir"

Esto no debería ocurrir ya que la aplicación está notarizada por Apple. Si lo ves:
1. Confirma que la descargaste desde la página oficial de versiones, no un espejo.
2. Revisa el sello de notarización: `xcrun stapler validate HeartBeatAgents.app`.
3. Si el sello es válido pero macOS igual lo rechaza, la descarga en sí probablemente estaba corrupta. Vuelve a descargarla y verifica su suma de comprobación SHA256.

## Aviso de Windows SmartScreen

El instalador está firmado con EV, así que SmartScreen debería aceptarlo sin aviso. Si ves uno, verifica la firma con `Get-AuthenticodeSignature HeartBeatAgents-Setup-<version>.exe` en PowerShell: `Status` debe indicar `Valid` y el firmante debe incluir Mosaic Singularity Inc. Si no es así, no ejecutes el instalador; repórtalo a `ops@mosaicsingularity.com`.

## Relacionado

- [Instalación](/es/docs/getting-started/installation): los instaladores y sumas de comprobación a los que se aplican estos problemas
- [Docker Desktop no se inicia](/es/docs/troubleshooting/docker-wont-start): una instalación que funciona pero no se lanza, a diferencia de una que no se instala