L'installeur ne s'exécute pas ou échoue à la vérification

« Docker est requis mais non installé »

Installez Docker Engine (Linux) ou Docker Desktop (macOS/Windows) depuis docker.com, puis vérifiez avec docker info et docker compose version.

« Permission refusée » en exécutant Docker sur Linux

Votre utilisateur n'est pas encore dans le groupe docker : sudo usermod -aG docker $USER, puis déconnectez-vous et reconnectez-vous, et confirmez avec groups | grep docker.

L'AppImage ne se lance pas sur Ubuntu 22.04+

Installez la bibliothèque de compatibilité FUSE 2 : sudo apt install libfuse2t64 sur Ubuntu 24.04+, ou sudo apt install libfuse2 sur Ubuntu 22.04. Si vous préférez ne pas l'installer, exécutez l'AppImage avec --appimage-extract-and-run à la place.

Conflit de port (9500, 9100, ou similaire déjà utilisé)

install.sh recherche automatiquement un port libre, en partant du port préféré et en incrémentant. Vérifiez ~/.heartbeatagents/.env pour voir quels ports il a réellement alloués.

La vérification de signature GPG échoue

1. Confirmez que vous avez importé la bonne clé publique : gpg --list-keys --fingerprint ops@mosaicsingularity.com. Empreinte attendue : 3041 1399 8510 1531 C54B 0498 1009 78CA B0A0 5886.
2. Si l'empreinte ne correspond pas, ne faites pas confiance au paquet. Quelqu'un a peut-être altéré la clé ou le fichier.
3. Signalez toute altération suspectée à ops@mosaicsingularity.com.

macOS dit que l'application « est endommagée » ou « ne peut pas être ouverte »

Cela ne devrait pas arriver puisque l'application est notarisée par Apple. Si vous le voyez :

1. Confirmez que vous avez téléchargé depuis la page de version officielle, pas un miroir.
2. Vérifiez l'agrafage de notarisation : xcrun stapler validate HeartBeatAgents.app.
3. Si l'agrafage est valide mais que macOS refuse quand même, le téléchargement lui-même était probablement corrompu. Retéléchargez et vérifiez sa somme de contrôle SHA256.

Avertissement Windows SmartScreen

L'installeur est signé EV, donc SmartScreen devrait l'accepter sans avertissement. Si vous en voyez un, vérifiez la signature avec Get-AuthenticodeSignature HeartBeatAgents-Setup-<version>.exe dans PowerShell : Status doit indiquer Valid et le signataire doit inclure Mosaic Singularity Inc. Si ce n'est pas le cas, n'exécutez pas l'installeur ; signalez-le à ops@mosaicsingularity.com.

À voir aussi

• Installation : les installeurs et sommes de contrôle auxquels ces problèmes s'appliquent
• Docker Desktop ne démarre pas : une installation qui tourne mais ne se lance pas, par opposition à une qui ne s'installe pas