Votre bureau ne démarre pas

Symptômes#

Votre bureau est bloqué en pending ou booting depuis plus de deux minutes, ou il passe directement à stopped sans jamais atteindre running.

La plupart du temps, un nouvel essai suffit.

La séquence de démarrage#

Quand vous créez un bureau, il passe par trois étapes :

1. Pending -- la VM est clonée à partir de l'image de base
2. Booting -- le processus d'initialisation configure le système et démarre les services
3. Running -- la VM signale une adresse IP et tout est opérationnel

Ça prend normalement 30 à 60 secondes. Au-delà de deux minutes, quelque chose a coincé.

Causes possibles#

Échec de l'initialisation#

Le processus d'initialisation gère la configuration initiale : vos clés API, l'environnement de bureau, l'agent. S'il échoue ou expire, votre bureau reste bloqué en booting.

La VM ne signale pas son statut#

SpineOS surveille la VM pour détecter quand elle est prête. Si le système de rapport de statut de la VM n'a pas démarré, la plateforme ne peut pas savoir que la VM est prête.

Capacité de l'infrastructure#

Il arrive que l'hôte n'ait pas assez de ressources pour lancer une nouvelle VM. C'est rare et ça concerne surtout les périodes de forte utilisation.

Configuration du provider manquante#

Si vous créez un bureau sans avoir configuré de provider AI ni de clé API, la création échouera. Il faut une configuration valide avant de provisionner.

Quoi faire#

1. Patienter un peu#

Certains bureaux mettent jusqu'à 90 secondes à démarrer, surtout la première fois. Si le statut est booting et que ça fait moins d'une minute, attendez encore 30 secondes.

2. Arrêter et relancer#

Si ça fait plus de deux minutes :

• Cliquez sur Stop sur la carte du bureau
• Attendez que le statut passe à stopped
• Cliquez sur Start pour relancer

Un redémarrage propre règle la majorité des problèmes passagers.

3. Supprimer et recréer#

Si le redémarrage ne change rien, supprimez ce bureau et créez-en un nouveau. Ça force un clonage propre depuis l'image de base.

4. Vérifier la configuration du provider#

Ouvrez le formulaire de création et vérifiez que vous avez bien sélectionné un provider AI et saisi une clé API valide.

5. Contacter le support#

Si rien de tout ça ne marche, écrivez à contact@spinestudio.dev avec le nom de votre bureau et l'heure à laquelle vous avez tenté de le créer.

Éviter les échecs de démarrage#

• Configurez votre provider AI avant de créer un bureau
• Créez vos bureaux un par un, laissez chacun finir de démarrer avant de lancer le suivant
• Si les problèmes persistent, vérifiez la page de statut de SpineOS ou les réseaux sociaux pour d'éventuelles maintenances