# L’app ne démarre pas

> Canal public — documentation de l’application 3.6.3. Respecter les mentions de disponibilité propres à chaque service.

Source : [L’app ne démarre pas](/aide/demarrage/)

Un démarrage qui échoue se joue presque toujours à trois endroits : la configuration de la machine, la couche de virtualisation de Windows, ou l’affichage de la fenêtre. Les symptômes sont différents, les gestes aussi. Commence par identifier le tien.

Arbre de décision : selon ce qui se passe au lancement, vérifier la configuration, relancer en mode graphique de compatibilité, réessayer le démarrage de l’environnement ou demander une aide adaptée pour la récupération Windows. — Au lancement… — Rien ne s’ouvre, ou — la configuration est — refusée — La fenêtre s’ouvre — et reste blanche — « L’environnement — n’a pas démarré » — Windows ne — redémarre plus après — l’accélération — Vérifier la — configuration requise — et la virtualisation — Relancer en mode — graphique de — compatibilité — Réessayer, puis le — diagnostic de — récupération — Contacter le support — pour la récupération — de Windows

Quatre symptômes de démarrage, quatre gestes distincts. Les trois derniers ne concernent que Windows.

## Avant de commencer

Note la version de ton application et ce qui s’affiche à l’écran, mot pour mot. Si tu comptes demander de l’aide, **ne relance pas l’app deux fois avant d’avoir récupéré tes journaux** : ils sont remis à zéro à chaque démarrage. Le détail est dans [Trouver tes journaux et signaler un bug](/aide/journaux/).

## L’installation est bloquée, ou la configuration est refusée

**Windows affiche un avertissement SmartScreen à l’installation.** C’est le certificat de signature, récent. Clique Informations complémentaires, puis Exécuter quand même. L’installeur est bien signé.

**L’étape Matériel affiche « Ce PC nécessite une correction »** (« Ce Mac nécessite une correction » sur Mac). La machine est sous le minimum : moins de 6 Go de mémoire vive, moins de deux fils d’exécution processeur, moins de 5 Go d’espace libre, ou un système non pris en charge. Libère de l’espace, ou change de machine : cette étape ne laisse pas passer, et il n’existe pas de contournement.

Copier le diagnostic copie le résultat des vérifications, à joindre à une demande au support. Le détail des prérequis est dans [Vérifier que ton ordinateur est compatible](/application/premiers-pas/compatibilite/).

## La fenêtre s’ouvre mais reste blanche

L’application répond, mais son affichage reste vide : c’est le processus graphique de la fenêtre qui plante en boucle. Ce problème ne touche que Windows.

**L’application s’en charge toute seule.** Après trois plantages graphiques rapprochés, elle redémarre une fois en **mode graphique de compatibilité** et garde ce mode aux lancements suivants, y compris depuis ton raccourci. Tu n’as rien à faire : laisse-la redémarrer. Dans ce mode, les aperçus 3D peuvent être dégradés ou indisponibles.

Si le problème persiste **malgré** ce mode, l’app arrête d’essayer plutôt que de redémarrer en boucle. Une fenêtre Windows s’ouvre, intitulée « VibeStarter — problème d’affichage », avec un seul bouton Fermer VibeStarter. Elle te demande de contacter le support en joignant tes journaux — voir [Trouver tes journaux et signaler un bug](/aide/journaux/).

Forcer le mode de compatibilité toi-même

Si la fenêtre reste blanche sans que l’app bascule d’elle-même, tu peux la lancer en mode logiciel à la main. Ferme complètement VibeStarter, ouvre PowerShell et lance ces deux lignes :

Fenêtre de terminal

```
$env:VIBESTARTER_DISABLE_GPU = "1"& "$env:LOCALAPPDATA\Vibe Starter\vibe-starter.exe"
```

Adapte le chemin si tu as installé l’app sur un autre disque. Pour revenir au fonctionnement habituel, ferme cette fenêtre PowerShell et relance l’app depuis son raccourci.

Si l’écran reste blanc même dans ce mode, ce n’est pas la même cause : récupère tes journaux et signale-le.

## Les agents rament, ou l’environnement met une éternité à démarrer

-   [Windows](/aide/demarrage/#tab-panel-0-0)
-   [Mac](/aide/demarrage/#tab-panel-0-1)

Sans accélération matérielle, l’application utilise l’émulation logicielle. Un bandeau **Mode dégradé** le signale : les agents, l’édition et la synchronisation restent accessibles, avec des performances réduites. Les nouveaux calculs Blender sont indisponibles, y compris les retouches, pour éviter des échecs répétés. Les modèles Blender déjà créés restent consultables et enregistrables.

Clique sur **Voir le diagnostic** pour ouvrir Paramètres → Application → Accélération VM. Le bouton **Comprendre le diagnostic** explique les options sans changer les réglages Windows.

Tu peux choisir de rester en TCG et fermer le bandeau avec sa croix **Continuer en TCG et masquer ce bandeau**. Ce choix est conservé après redémarrage de l’app et s’applique aussi au bandeau de l’atelier Blender. Le diagnostic reste accessible dans les paramètres ; coche **Afficher le bandeau quand l’environnement utilise TCG** pour le réafficher. Masquer le bandeau ne réactive pas les calculs Blender et ne change pas le mode utilisé.

Blender se réactive quand l’environnement a effectivement démarré avec l’accélération. Une détection favorable dans les paramètres ne suffit pas si l’environnement en cours utilise encore TCG : sauvegarde ton travail, quitte complètement VibeStarter puis rouvre-le.

Pour comprendre les résultats et les précautions, lis [Activer l’accélération sur Windows](/aide/demarrage/#activer-lacc%C3%A9l%C3%A9ration-sur-windows).

Ce diagnostic ne s’applique pas : l’accélération est native sur Apple Silicon. Si les agents sont lents sur un Mac, regarde plutôt du côté de la mémoire disponible et du nombre d’agents lancés, dans [Mon agent ne répond pas, ou mon quota fond](/aide/agents/).

## Activer l’accélération sur Windows

L’accélération repose sur **Windows Hypervisor Platform (WHPX)**. VibeStarter fournit un diagnostic et une aide à sa compréhension. L’application ne propose plus d’activer les fonctions Windows, de préparer un démarrage d’essai ou de rendre l’activation permanente. Elle utilise WHPX quand il est déjà disponible ; tu peux aussi choisir de rester en TCG.

### Comprendre le diagnostic

Dans Paramètres → Application → Accélération VM, clique sur **Revérifier WHPX** pour actualiser le résultat, puis sur **Comprendre le diagnostic**. Les **Détails techniques** donnent le résultat à joindre à une demande de support.

-   **Si WHPX est disponible** et que l’environnement est encore en TCG, ferme ton travail et relance complètement VibeStarter. Aucun changement Windows n’est nécessaire dans ce parcours.
-   **Si WHPX n’est pas disponible** : le support peut t’aider à interpréter ce que l’app détecte. La cause peut dépendre des fonctions Windows, du firmware ou d’autres logiciels ; ce résultat seul ne suffit pas à identifier une incompatibilité.
-   **Si la virtualisation est désactivée dans le BIOS/UEFI** : consulte ton administrateur ou les indications du fabricant pour le modèle exact de ton ordinateur avant toute intervention.

Les éventuelles modifications se font hors de VibeStarter, selon les indications de Microsoft et du fabricant. **Une modification manuelle présente elle aussi des risques** pour le démarrage et les autres logiciels. Sauvegarde tes fichiers importants et garde ta clé de récupération BitLocker accessible depuis un autre appareil si le disque est chiffré. Ne communique pas cette clé au support. Sur un PC professionnel ou scolaire, passe par l’administrateur.

### Si une ancienne version avait déjà lancé un essai

La carte signale **Ancien essai d’accélération à clôturer** si VibeStarter retrouve un ancien essai ou une entrée de démarrage restante. Elle ne permet plus de confirmer cet ancien essai pour activer durablement l’hyperviseur.

**Annuler l’essai** et **Retirer l’entrée de démarrage** restent disponibles uniquement pour cet ancien parcours identifié. Ces actions demandent une confirmation puis une autorisation administrateur ; elles modifient encore Windows et comportent des risques. L’annulation désactive l’hyperviseur au prochain démarrage : les logiciels qui en dépendent, comme WSL2 ou Docker Desktop, peuvent être affectés. Les fonctions Windows restent installées. Si une entrée est encore utilisée par Windows, il faut redémarrer avant de pouvoir la retirer.

Avant d’accepter, sauvegarde ton travail, ferme les agents et garde ta clé BitLocker accessible. Si BitLocker est actif, sa protection est suspendue pour un redémarrage ; vérifie ensuite qu’elle a repris. Si un contrôle ou une opération échoue, garde le message et contacte le support avant de recommencer : des changements partiels peuvent avoir eu lieu.

La désinstallation de VibeStarter **ne rétablit pas les réglages Windows**. Si l’app ne retrouve pas l’ancien essai, elle ne propose pas de désactivation générale de l’hyperviseur : contacte le support pour comprendre la situation.

## Windows ne redémarre plus après avoir activé l’accélération

Si une ancienne activation ou une intervention manuelle est suivie d’un blocage, évite les essais répétés et les changements du BIOS au hasard. Contacte l’administrateur ou le support avec le modèle du PC, le message d’erreur et les changements effectués. Les outils de récupération de Windows peuvent demander la clé BitLocker : garde-la accessible depuis un autre appareil et ne la communique pas au support.

L’app ne peut pas effectuer un retour arrière si Windows ne démarre pas. Une récupération adaptée à la machine peut être nécessaire ; aucun parcours ne garantit le rétablissement de toutes les configurations.

## « L’environnement n’a pas démarré »

1.  Clique Réessayer. Le second essai aboutit presque toujours.
    
2.  Si l’échec se répète, ouvre Détails techniques et garde le texte affiché pour ton signalement.
    
3.  Redémarre l’application.
    
4.  Si l’écran « VibeStarter ne peut pas démarrer ton espace de travail » apparaît, il propose jusqu’à trois actions : Réessayer le démarrage, puis Recréer le disque et restaurer mes projets, puis Repartir de zéro. Va du premier vers le dernier, pas l’inverse. La deuxième remet tes projets depuis une archive de ton ordinateur ; le code de tes projets sauvegardés en ligne se remet ensuite à jour tout seul. La troisième ne restaure rien : seul le code sauvegardé en ligne reste récupérable, depuis ta liste de projets.
    

## Limites

-   Le mode graphique de compatibilité **contourne** le plantage d’affichage, il ne le répare pas : la cause est dans le pilote graphique ou le runtime de la machine.
-   Le BIOS, l’UEFI, les pilotes et les micrologiciels sortent du périmètre du support, ainsi que les instabilités système qu’ils provoquent.
-   Il n’existe pas de version Linux distribuée, pas de version Mac Intel, et pas de version Windows sur ARM.

## Pour aller plus loin

-   [Vérifier que ton ordinateur est compatible](/application/premiers-pas/compatibilite/)
-   [Installer sur Windows](/application/premiers-pas/installer-windows/) et [Installer sur Mac](/application/premiers-pas/installer-mac/)
-   [Trouver tes journaux et signaler un bug](/aide/journaux/)
-   [Obtenir de l’aide](/aide/)