HeartBeatAgents

El instalador no se ejecuta o falla la verificación

Ver como Markdown

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: los instaladores y sumas de comprobación a los que se aplican estos problemas
  • Docker Desktop no se inicia: una instalación que funciona pero no se lanza, a diferencia de una que no se instala