# Dépannage de Moon Desktop

> Résoudre les problèmes de Moon Desktop sous Windows et Linux : SmartScreen, AppImage, raccourci déjà pris, mises à jour, appli qui ne démarre pas, Code.

## Windows : « Windows a protégé votre ordinateur »

Tant que Moon Desktop n’a pas de signature de Windows, SmartScreen peut afficher cet avertissement à l’ouverture de l’installeur. Si vous avez téléchargé le fichier depuis [la page Moon Desktop](https://realmoon.ai/moon-desktop/) de realmoon.ai :

1. Cliquez sur « Informations complémentaires ».
2. Vérifiez que le nom du fichier est bien celui que vous avez téléchargé. Pour aller plus loin, comparez son empreinte avec celle publiée : voir [Vérifier un fichier](https://realmoon.ai/documentation/moon-desktop/installation/#verifier).
3. Cliquez sur « Exécuter quand même ».

N’ouvrez jamais un installeur de Moon Desktop reçu par e-mail ou téléchargé ailleurs que sur realmoon.ai. Un antivirus d’entreprise peut aussi bloquer l’installeur : demandez à votre service informatique.

## Sur Mac

La version pour Mac est en cours de validation par Apple : elle n’est pas encore proposée au téléchargement. N’installez pas une version pour Mac trouvée ailleurs que sur realmoon.ai.

## Linux : l’AppImage ne s’ouvre pas

1. Rendez le fichier exécutable : `chmod +x MoonDesktop-*.AppImage`, ou dans les propriétés du fichier, « Autoriser l’exécution ».
2. Si rien ne se passe ou si un message parle de FUSE, installez la bibliothèque FUSE 2 :

```bash title="Ubuntu 22.04, Debian"
sudo apt install libfuse2
```

```bash title="Ubuntu 24.04"
sudo apt install libfuse2t64
```

```bash title="Fedora"
sudo dnf install fuse-libs
```

Le paquet `.deb` n’a pas besoin de FUSE : `sudo apt install ./MoonDesktop-1.0.1.deb`. Il ne se met pas à jour seul.

## Le raccourci de la fenêtre rapide ne marche pas

« Raccourci indisponible » : « … est déjà utilisé par une autre application. Choisissez-en un autre dans les réglages de l’appli. » Une autre application a déjà pris ce raccourci (sous Windows, par exemple un lanceur comme PowerToys Run, qui utilise aussi `Alt` `Espace`).

1. Ouvrez le menu Fichier › « Réglages de l’appli ».
2. Changez « Raccourci de la fenêtre rapide » (ou « Raccourci de la capture d’écran »), par exemple `Ctrl` `Alt` `Espace`.

| Message | Ce qu’il veut dire |
| --- | --- |
| « Ce raccourci est déjà utilisé par une autre application. » | Choisissez-en un autre : l’ancien raccourci reste actif. |
| « Ce raccourci est réservé au système. » | Le système le garde pour lui. |
| « Ce raccourci sert déjà à écrire (copier, coller, annuler…) : choisissez-en un autre. » | Il servirait déjà dans toutes vos applications. |
| « La fenêtre rapide et la capture d’écran doivent avoir des raccourcis différents. » | Donnez-leur deux raccourcis distincts. |

La fenêtre rapide et la capture restent aussi accessibles depuis l’icône de la zone de notification.

## La mise à jour ne s’installe pas

- « Redémarrer pour mettre à jour » s’affiche : cliquez dessus, ou quittez Moon Desktop. La mise à jour s’installe à la fermeture.
- « La vérification des mises à jour n’a pas abouti. » : vérifiez la connexion, puis réessayez plus tard par le menu Aide › « Vérifier les mises à jour ». Derrière un proxy d’entreprise, l’adresse `https://realmoon.ai/dl/desktop/` doit être joignable.
- « Les mises à jour automatiques ne sont pas disponibles dans cette version. » : c’est la version portable de Windows ou le paquet `.deb`. Téléchargez la nouvelle version depuis la page Moon Desktop.

## L’appli ne démarre pas ou reste sur un écran d’attente

- **Écran « hors ligne » avec « Réessayer »** : l’ordinateur n’a pas de réseau. Moon Desktop revient d’elle-même à Moon AI dès que le réseau revient.
- **« Moon AI ne répond pas »** : le service est momentanément injoignable ; l’appli réessaie seule, de plus en plus espacé. Voyez l’[état des services](https://realmoon.ai/statut/).
- **Rien ne s’ouvre** : Moon Desktop ne s’ouvre qu’une fois. Cherchez son icône dans la zone de notification et cliquez sur « Ouvrir Moon Desktop ».
- **L’appli se ferme aussitôt** : redémarrez l’ordinateur, puis réinstallez Moon Desktop. Si cela continue, écrivez au support en joignant le journal de l’appli : `main.log`, dans le dossier `logs` des données de Moon Desktop (`%APPDATA%\Moon Desktop\logs` sous Windows, `~/.config/Moon Desktop/logs` sous Linux). Le journal ne contient pas le texte de vos conversations.

## Code ne démarre pas

Voir [Si Code ne démarre pas](https://realmoon.ai/documentation/moon-desktop/code/#probleme) et le [Dépannage de Moon CLI](https://realmoon.ai/documentation/moon-cli/depannage/).

## Contacter le support

Écrivez à [contact@stellarrstudio.com](mailto:contact@stellarrstudio.com) avec votre système, la version de Moon Desktop (menu Aide › « À propos de Moon Desktop ») et le message exact. Voir aussi [Obtenir de l’aide](https://realmoon.ai/documentation/compte/support/).

## Voir aussi

- [Installer Moon Desktop](https://realmoon.ai/documentation/moon-desktop/installation/)
- [Code dans Moon Desktop](https://realmoon.ai/documentation/moon-desktop/code/)

---

Documentation Moon AI › Moon Desktop › Dépannage. Page : https://realmoon.ai/documentation/moon-desktop/depannage/. Modifiée le 8 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.