Skip to main content
La plataforma xkat permite realizar prácticas interactivas directamente en el navegador.
Para cursos avanzados que requieren hardware local (p. ej. Arduino) o máquinas virtuales aisladas (Ubuntu Lab VM), el Agente Local (xkat-cli) conecta su navegador con su computadora de manera segura.
Aviso de Seguridad: El agente local nunca abre puertos a Internet. Se comunica exclusivamente dentro de su propia máquina (localhost:127.0.0.1). Los comandos solo se ejecutan con su autorización.

1. Inicio Rápido (Quick Start)

Abra el terminal de su computadora (PowerShell, Terminal o Bash) y ejecute este comando:
Una vez ejecutado, el estado en el reproductor web de xkat cambiará automáticamente a [En línea] en cuestión de segundos.

2. Guía por Sistema Operativo

Configuración en Windows

  • Terminal: Abra PowerShell, Windows Terminal o el Símbolo del sistema (CMD).
  • Comando:
  • Para Prácticas con Máquina Virtual (Lab VM):
    • Se recomienda Windows 10/11 de 64 bits.
    • Abra el Administrador de tareas (Ctrl+Shift+Esc) → pestaña [Rendimiento] y compruebe que Virtualización: Habilitado esté activo.

3. Solución de Problemas (Troubleshooting)

Si experimenta algún inconveniente de conexión, consulte las siguientes soluciones:
Esto ocurre cuando el entorno Node.js no está instalado en su sistema.
  • Windows: Descargue e instale la versión LTS desde nodejs.org o use PowerShell:
  • macOS: Instale desde nodejs.org o mediante Homebrew:
  • Linux (Ubuntu/Debian):
Tras instalar, cierre y vuelva a abrir el terminal y ejecute de nuevo npx -y xkat-cli@latest up.
  • Mantenga el terminal abierto: Asegúrese de que la ventana del terminal con el comando del agente permanezca abierta.
  • Liberar puerto y reiniciar: Si el puerto 38000–38050 está bloqueado por una sesión previa, reinicie el agente con:
  • Cortafuegos o Antivirus: Compruebe que ningún software de seguridad corporativo esté bloqueando la conexión interna a 127.0.0.1.
  • Virtualización en Windows:
    • Si en el Administrador de tareas la Virtualización figura como Deshabilitada, acceda a la configuración BIOS/UEFI al reiniciar el PC y active Intel VT-x o AMD SVM.
  • Reinicio completo de la VM:
    • Ejecute el siguiente comando para regenerar la máquina virtual desde cero:
Para detener los procesos en segundo plano de manera segura: