Skip to main content
La plateforme xkat permet d’effectuer la majorité des exercices directement dans votre navigateur web.
Pour les cours avancés nécessitant du matériel embarqué (ex. Arduino) ou une machine virtuelle isolée (Ubuntu Lab VM), l’Agent Local (xkat-cli) relie votre navigateur à votre ordinateur en toute sécurité.
Sécurité : L’agent local n’ouvre aucun port sur Internet. Il communique exclusivement en interne sur votre machine (localhost:127.0.0.1). Les commandes ne sont exécutées qu’avec votre accord.

1. Démarrage Rapide (Quick Start)

Ouvrez le terminal de votre ordinateur (PowerShell, Terminal ou Bash) et exécutez cette commande :
Une fois la commande lancée, l’état dans le lecteur web xkat passera automatiquement à [En ligne] en quelques secondes.

2. Guide par Système d’Exploitation

Configuration sous Windows

  • Terminal : Ouvrez PowerShell, Windows Terminal ou l’Invite de commandes (CMD).
  • Commande :
  • Machine Virtuelle (Lab VM) :
    • Windows 10/11 64 bits recommandé.
    • Ouvrez le Gestionnaire des tâches (Ctrl+Maj+Échap) → onglet [Performances] et vérifiez que Virtualisation : Activé est bien affiché.

3. Dépannage et FAQ (Troubleshooting)

Si vous rencontrez des difficultés de connexion, suivez les indications ci-dessous :
Cela signifie que l’environnement Node.js n’est pas installé sur votre système.
  • Windows : Téléchargez et installez la version LTS depuis nodejs.org ou via PowerShell :
  • macOS : Installez depuis nodejs.org ou via Homebrew :
  • Linux (Ubuntu/Debian) :
Après l’installation, fermez et rouvrez votre terminal, puis réexécutez npx -y xkat-cli@latest up.
  • Garder le terminal ouvert : Vérifiez que la fenêtre du terminal exécutant l’agent reste bien ouverte.
  • Libérer le port et redémarrer : Si le port 38000–38050 est occupé par un ancien processus, redémarrez l’agent avec :
  • Pare-feu / Antivirus : Assurez-vous que votre logiciel de sécurité ne bloque pas la communication locale sur 127.0.0.1.
  • Virtualisation Windows :
    • Si la virtualisation est désactivée dans le Gestionnaire des tâches, activez Intel VT-x ou AMD SVM dans les paramètres BIOS/UEFI au démarrage de votre PC.
  • Réinitialisation complète de la VM :
    • Lancez la commande suivante pour régénérer la VM proprement :
Exécutez cette commande dans votre terminal pour libérer les ressources en arrière-plan :