---
title: L'installeur ne s'exécute pas ou échoue à la vérification
summary: Docker manquant, erreurs de permission, échecs de lancement AppImage, conflits de port, et problèmes de vérification de signature, avec la correction pour chacun.
date: 2026-09-10
---

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

Docker manquant, erreurs de permission, échecs de lancement AppImage, conflits de port, et problèmes de vérification de signature, avec la correction pour chacun.

## « 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](/fr/docs/getting-started/installation) : les installeurs et sommes de contrôle auxquels ces problèmes s'appliquent
- [Docker Desktop ne démarre pas](/fr/docs/troubleshooting/docker-wont-start) : une installation qui tourne mais ne se lance pas, par opposition à une qui ne s'installe pas