Saltar al contenido principal
Soluciona problemas comunes relacionados con el entorno del sistema, shell y dependencias.

​
PowerShell no reconocido

Problema: Mensaje de error “PowerShell no se reconoce como un comando interno o externo”. Soluciones:
  • Usuarios de Windows:
    • Agrega PowerShell al PATH del sistema
    • Abre Configuracion → Sistema → Acerca de → Configuracion avanzada del sistema → Variables de entorno
    • Agrega la ruta de PowerShell: C:\Windows\System32\WindowsPowerShell\v1.0\
    • Reinicia SoloEnt despues de cambiar el PATH
  • Alternativa:
    • Usa el Simbolo del sistema (cmd) en su lugar
    • Cambia el terminal predeterminado en Configuracion
    • Reinstala PowerShell si falta

​
Comando no encontrado

Problema: El terminal muestra “comando no encontrado” o errores similares. Soluciones:
  • Verifica que el comando/herramienta este instalado en tu sistema
  • Comprueba si el comando esta en el PATH del sistema
  • Reinicia el terminal despues de instalar nuevas herramientas
  • Usa la ruta completa al ejecutable si es necesario
  • Instala las dependencias faltantes

​
Python/Node no encontrado

Problema: Los comandos de Python o Node.js no funcionan. Soluciones:
  • Instala Python desde python.org o Node.js desde nodejs.org
  • Verifica la instalacion: python --version o node --version
  • Agrega al PATH si esta instalado pero no se reconoce
  • Reinicia SoloEnt despues de la instalacion
  • Verifica conflictos de version (multiples versiones de Python/Node)

​
Errores de permiso denegado

Problema: Errores de “Permiso denegado” o “Acceso denegado”. Soluciones:
  • macOS/Linux:
    • Usa sudo si es apropiado
    • Verifica los permisos de archivo con ls -la
    • Concede Acceso Completo al Disco en Configuracion del Sistema
  • Windows:
    • Ejecuta SoloEnt como Administrador si es necesario
    • Verifica la configuracion de seguridad de la carpeta
    • Desactiva temporalmente el Control de Cuentas de Usuario

​
Ruta con espacios causa errores

Problema: Los comandos fallan cuando las rutas de archivo contienen espacios. Soluciones:
  • Encierra las rutas entre comillas: "C:\Mis Documentos\proyecto"
  • Usa caracteres de escape en el terminal
  • Evita espacios en los nombres de carpetas de proyectos
  • Usa guiones o guiones bajos en su lugar: mi-proyecto no mi proyecto

​
Git no disponible

Problema: Los comandos de Git no funcionan o Git no se encuentra. Soluciones:
  • Instala Git desde git-scm.com
  • Verifica la instalacion: git --version
  • Agrega Git al PATH del sistema
  • Reinicia el terminal/SoloEnt despues de la instalacion
  • Usa GitHub Desktop como alternativa

​
Variables de entorno no configuradas

Problema: La aplicacion no puede encontrar las variables de entorno requeridas. Soluciones:
  • Configura las variables en la configuracion del sistema (no solo en la sesion del terminal)
  • Windows: Propiedades del Sistema → Variables de entorno
  • macOS/Linux: Agrega a ~/.zshrc o ~/.bashrc
  • Reinicia SoloEnt despues de configurar las variables
  • Verifica con echo $NOMBRE_VARIABLE (Unix) o echo %NOMBRE_VARIABLE% (Windows)

​
Problemas de compatibilidad de shell

Problema: Los comandos funcionan en un shell pero no en otro. Soluciones:
  • Verifica que shell estas usando: echo $SHELL
  • Cambia a un shell compatible (bash, zsh, PowerShell)
  • Configura el shell predeterminado en la configuracion de SoloEnt
  • Usa comandos multiplataforma cuando sea posible

​
Desajuste de arquitectura del sistema

Problema: Herramientas o binarios incompatibles con tu sistema. Soluciones:
  • Verifica la arquitectura del sistema: uname -m (Unix) o systeminfo (Windows)
  • Descarga la version correcta (x64, ARM64, etc.)
  • Usa alternativas compatibles
  • Habilita Rosetta 2 en Macs con Apple Silicon si es necesario

​
Antivirus bloquea operaciones

Problema: El software antivirus interfiere con las operaciones de SoloEnt. Soluciones:
  • Agrega SoloEnt a la lista blanca/excepciones del antivirus
  • Desactiva temporalmente el antivirus para probar
  • Revisa los registros del antivirus para acciones bloqueadas
  • Contacta al soporte del antivirus para la configuracion adecuada

​
Problemas de espacio en disco

Problema: Las operaciones fallan debido a espacio insuficiente en disco. Soluciones:
  • Verifica el espacio disponible en disco
  • Limpia archivos temporales y caches
  • Mueve el proyecto a una unidad con mas espacio
  • Elimina archivos innecesarios

​
Problemas de red/firewall

Problema: No se puede conectar a servicios API o descargar actualizaciones. Soluciones:
  • Verifica la configuracion del firewall
  • Permite SoloEnt a traves del firewall
  • Configura los ajustes de proxy si estas detras de un firewall corporativo
  • Prueba la conexion con una red diferente
  • Contacta al departamento de TI para entornos empresariales
Muchos problemas de entorno se resuelven reiniciando SoloEnt despues de hacer cambios en el sistema como actualizaciones de PATH o instalar nuevas herramientas.

​
Sigues teniendo problemas?

Soporte por Correo

Contacta a nuestro equipo de soporte con detalles del entorno

Unete a Discord

Obtén ayuda de la comunidad

Solucion de Problemas Principal

Volver al indice de solucion de problemas

Inicio Rapido

Volver a la guia de configuracion

​
Reportar problemas de entorno

Al reportar problemas de entorno, incluye:
  • Sistema operativo: Windows 10/11, version de macOS, distribucion de Linux
  • Arquitectura del sistema: x64, ARM64, Apple Silicon
  • Tipo de shell: PowerShell, CMD, bash, zsh
  • Mensajes de error: Texto completo de cualquier error
  • Pasos intentados: Lo que intentaste antes de reportar
Esta informacion nos ayuda a diagnosticar y resolver problemas mas rapidamente.