Aide

Dépannage

Les problèmes que l'on rencontre vraiment avec Solon, dans l'ordre où on les croise, et que faire. Chacun prend une minute. Si le vôtre n'y est pas, l'export de diagnostic en bas de page est le chemin le plus court vers une correction.

Windows bloque l'installateur (SmartScreen)

Un écran bleu « Windows a protégé votre ordinateur » apparaît au lancement de Solon_x.y.z_x64-setup.exe.

  1. Cliquez sur Informations complémentaires, puis Exécuter quand même. L'écran signifie que l'installateur n'est pas encore signé, pas qu'il est dangereux.
  2. Pour être sûr de ce que vous lancez : comparez le SHA-256 du fichier avec celui publié à côté de la version (Get-FileHash .\Solon_x.y.z_x64-setup.exe dans PowerShell). La page d'accueil l'affiche aussi.
  3. Certains antivirus mettent en quarantaine les installateurs non signés : restaurez le fichier et ajoutez une exception avant de le relancer.

Une signature via la SignPath Foundation a été demandée ; les versions seront signées dès l'acceptation du projet, et cet écran disparaîtra.

Le moteur ne démarre pas après l'installation

Solon affiche « Le moteur n'a pas démarré » avec un code comme WINDOWS_FEATURE_MISSING, HYPERVISOR_NOT_RUNNING ou VIRTUALIZATION_DISABLED_IN_FIRMWARE.

  1. Redémarrez d'abord. L'installateur active Hyper-V et la Plateforme de machine virtuelle s'ils étaient éteints ; ils ne fonctionnent qu'après un redémarrage. La plupart des échecs du premier démarrage s'arrêtent là.
  2. Code VIRTUALIZATION_DISABLED_IN_FIRMWARE : activez la virtualisation matérielle dans le BIOS/UEFI (Intel VT-x, AMD-V ou SVM, en général sous Advanced, CPU ou Security), enregistrez, redémarrez.
  3. Windows Famille est pris en charge depuis 0.1.12 : l'installateur active la Plateforme de machine virtuelle et demande un redémarrage. Il faut Windows 10 22H2 ou 11, toutes éditions.
  4. Code HYPERVISOR_NOT_RUNNING : un vieux VirtualBox ou VMware, ou un réglage bcdedit, a éteint l'hyperviseur Windows. Retirez-les ou mettez-les à jour (VirtualBox ≥ 6.1, VMware ≥ 15.5), puis en PowerShell administrateur : bcdedit /set hypervisorlaunchtype auto et redémarrez.
  5. Toujours bloqué : Réglages → Diagnostic → Exporter un diagnostic, et ouvrez un rapport avec le zip (voir plus bas).

Une pile refuse de démarrer : un port est déjà pris

Up échoue et la sortie dit « port is already allocated » ou « address already in use », ou Solon affiche « Le port 8080 est déjà utilisé sur ce PC ».

  1. Un autre programme (une autre pile, IIS, un serveur de développement, Docker Desktop) écoute déjà sur ce port. Solon nomme le port et propose le suivant libre : cliquez sur Utiliser 8081 au lieu de 8080 dans la galerie, ou dans l'onglet Compose du projet changez le port hôte (le nombre de gauche dans "8080:80") puis Save and Up.
  2. Vous n'avez peut-être pas besoin de publier un port : chaque conteneur répond sur https://<nom>.solon.local, port ou pas. Commentez les lignes ports: et utilisez cette adresse.
  3. Deux exemplaires de la même pile (deux WordPress, deux Odoo) se heurtent toujours sur le même port : donnez un autre port hôte au second, ou retirez les ports et utilisez les deux adresses solon.local.

Un conteneur « ne fait rien » ou s'arrête aussitôt

Vous cliquez sur Run ou Start, le conteneur apparaît une seconde puis passe en Exited ; hello-world est le cas classique.

  1. C'est normal pour un programme qui fait son travail et se termine : hello-world affiche son message et sort en un dixième de seconde. Solon ouvre ses journaux et indique « terminé aussitôt avec le code 0 » ; le message est dans l'onglet Logs.
  2. Un serveur qui sort avec un code non nul est un vrai échec : lisez les dernières lignes de ses journaux (onglet Logs, ou docker logs <nom>). Les causes habituelles : une variable d'environnement manquante, un chemin de volume faux, un port que le conteneur lui-même ne peut pas ouvrir.
  3. Un conteneur que Solon a endormi (icône lune) n'est pas arrêté : la requête suivante le réveille. Utilisez Keep awake sur sa page s'il exécute des tâches planifiées.

Pas de réseau dans les conteneurs, ou une adresse solon.local ne s'ouvre pas

apt ou pip expirent dans un conteneur, ou le navigateur n'atteint pas https://nom.solon.local.

  1. VPN d'entreprise. Certains clients VPN (AnyConnect, GlobalProtect, Zscaler) bloquent le trafic des cartes virtuelles. Déconnectez le VPN et réessayez ; si ça marche, indiquez-le dans votre rapport pour qu'un contournement soit trouvé.
  2. L'adresse. Un conteneur n'a une adresse que pendant qu'il tourne ; le nom est celui du conteneur (web.solon.local) ou service.projet.solon.local pour Compose. Ouvrez http://nimportequoi.solon.local : la page liste toutes les adresses disponibles.
  3. Le certificat. Les navigateurs et .NET reconnaissent les certificats locaux. curl.exe sur Windows a besoin de --ssl-no-revoke, comme avec mkcert.
  4. Des liens en http://. WordPress, Nextcloud et compagnie construisent leurs liens à partir de la requête : Solon transmet X-Forwarded-Proto: https, que les images officielles respectent. Pour un WordPress déjà installé en http, changez l'adresse du site dans Réglages → Général.
  5. Le fichier hosts. Solon écrit les noms dans C:\Windows\System32\drivers\etc\hosts entre # solon-begin et # solon-end. Un produit de sécurité qui protège ce fichier bloque les adresses : autorisez Solon ou ajoutez les noms à la main.

Le disque se remplit

Windows prévient que le lecteur C: est presque plein, ou Solon affiche « Disque du moteur presque plein ».

  1. Solon garde tout dans un seul fichier, %ProgramData%\Solon\data.vhdx, qui grossit avec les images, conteneurs et volumes et ne se réduit qu'après un nettoyage.
  2. Réglages → DisqueRécupérer l'espace : supprime les images qu'aucun conteneur n'utilise et le cache de construction, puis rend l'espace libéré à Windows. Les conteneurs et les volumes ne sont jamais touchés.
  3. Toujours gros ? Images → « Inutilisées seulement » montre ce qui reste ; Volumes → « Inutilisés seulement » montre les volumes qu'aucun conteneur ne référence (des données que vous voulez peut-être garder : vérifiez avant de supprimer).

Docker Desktop ou WSL est aussi installé

Les commandes docker parlent au mauvais moteur, ou Docker Hub refuse votre connexion.

  1. Solon et Docker Desktop cohabitent. Le moteur auquel la commande docker s'adresse dépend du docker.exe trouvé en premier dans votre PATH ; celui de Solon est dans son dossier d'installation. docker context ls montre le contexte courant.
  2. Erreurs « unauthorized » de Docker Hub : le CLI docker de Windows réutilise des identifiants stockés par Docker Desktop, parfois périmés. docker logout puis docker login règle le problème.
  3. WSL n'est pas utilisé par Solon et n'a besoin ni d'être installé ni d'être retiré.

Signaler un problème

Un fichier zip en dit plus qu'une capture d'écran. Cela prend dix secondes.

  1. Dans Solon : Réglages → Diagnostic → Exporter un diagnostic…, enregistrez le zip.
  2. Ouvrez un rapport de bug sur GitHub et déposez le zip dans le formulaire, avec ce que vous avez fait et ce que vous attendiez.
  3. Indiquez votre version de Windows (winver), et si un VPN, un autre antivirus, Docker Desktop ou WSL sont présents.

Le zip contient les journaux de Solon, son état et ses réglages, le rapport des prérequis, docker info et les versions. Il ne contient ni les données de vos conteneurs, ni mots de passe, ni identifiants Docker Hub ; vous pouvez l'ouvrir et vérifier avant d'envoyer.

Ouvrir un rapport de bug

Codes d'erreur

Chaque erreur affichée par Solon porte un code stable. Les journaux sont dans %ProgramData%\Solon\logs et se copient depuis l'écran d'erreur.

CodeCauseQue faire
VIRTUALIZATION_DISABLED_IN_FIRMWARE VT-x / AMD-V désactivé Activer la virtualisation dans le BIOS/UEFI (onglet Advanced, CPU ou Security), redémarrer.
WINDOWS_FEATURE_MISSING Hyper-V ou Plateforme de machine virtuelle désactivés Redémarrer si vous venez d'installer. Sinon réinstaller Solon (l'installeur les active) ou, en PowerShell administrateur : Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V,VirtualMachinePlatform -All, puis redémarrer.
WINDOWS_FEATURE_BLOCKED_BY_POLICY Stratégie d'entreprise (WSUS, GPO) refuse l'activation Demander à l'administrateur d'activer Microsoft-Hyper-V et VirtualMachinePlatform.
HYPERVISOR_NOT_RUNNING Hyperviseur Windows non démarré Désinstaller les anciens VirtualBox/VMware (< 6.1 / < 15.5), vérifier bcdedit /enum (hypervisorlaunchtype Auto), ne pas exécuter Solon dans une VM sans virtualisation imbriquée.
HOST_COMPUTE_SERVICE_UNAVAILABLE Service vmcompute ou hns arrêté ou absent Redémarrer Windows ; sinon réinstaller Solon.
BLOCKED_BY_SECURITY_SOFTWARE Antivirus / EDR bloque les disques ou le service Ajouter %ProgramData%\Solon et le dossier d'installation aux exclusions.
INSUFFICIENT_PRIVILEGES Le service ne tourne pas avec les droits attendus Réinstaller Solon (le service doit tourner en LocalSystem).
IMAGE_CORRUPTED Fichiers du moteur absents ou empreinte SHA-256 invalide Réinstaller Solon.
DATA_DISK_ERROR data.vhdx impossible à créer ou ouvrir Vérifier l'espace disque et les exclusions antivirus ; en dernier recours renommer %ProgramData%\Solon\data.vhdx (perte des données Docker).
VM_BOOT_TIMEOUT, AGENT_UNREACHABLE, ENGINE_UNREACHABLE La machine ne répond pas Redémarrer le moteur ; consulter solon-service.log ; signaler avec le zip de diagnostic.
Pas d'accès réseau depuis les conteneurs VPN d'entreprise ou conflit de plage IP Solon choisit une plage libre et fixe le MTU à 1400 ; certains VPN bloquent tout de même les cartes virtuelles : désactiver le VPN pour tester, puis signaler.
« Le service Solon n'est pas en cours d'exécution » Service arrêté sc start SolonService en administrateur, ou réinstaller.

Coupure de courant ou arrêt brutal : au démarrage suivant, Solon vérifie et répare le disque de données (fsck), puis redémarre le moteur. Les écritures non synchronisées des deux dernières secondes peuvent être perdues, comme sur toute machine Linux.

← Retour à l'accueil