Falló la conexión a la base de datos
# Check database is running
docker compose ps db
# Test connection
docker compose exec db psql -U postgres -c "SELECT 1"Verifica el formato de DATABASE_URL: postgresql://user:pass@host:5432/database
Los modelos de Ollama no se muestran
Dentro de Docker, localhost = el contenedor, no tu máquina host.
# For host-machine Ollama, use:
OLLAMA_URL=http://host.docker.internal:11434 # macOS/Windows
OLLAMA_URL=http://192.168.1.x:11434 # Linux (use actual IP)WebSocket/Tiempo real no funciona
- Comprueba que
NEXT_PUBLIC_SOCKET_URLcoincida con tu dominio - Verifica que el servicio en tiempo real esté funcionando:
docker compose ps realtime - Asegúrate de que el proxy inverso pase las actualizaciones de WebSocket (consulta la guía de Docker)
Error 502 Bad Gateway
# Check app is running
docker compose ps simstudio
docker compose logs simstudio
# Common causes: out of memory, database not readyErrores de migración
# View migration logs
docker compose logs migrations
# Run manually
docker compose exec simstudio bun run db:migratepgvector no encontrado
Usa la imagen correcta de PostgreSQL:
image: pgvector/pgvector:pg17 # NOT postgres:17Errores de certificado (CERT_HAS_EXPIRED)
Si ves errores de certificado SSL al llamar a APIs externas:
# Update CA certificates in container
docker compose exec simstudio apt-get update && apt-get install -y ca-certificates
# Or set in environment (not recommended for production)
NODE_TLS_REJECT_UNAUTHORIZED=0Página en blanco después del inicio de sesión
- Revisa la consola del navegador para ver errores
- Verifica que
NEXT_PUBLIC_APP_URLcoincida con tu dominio actual - Borra las cookies del navegador y el almacenamiento local
- Comprueba que todos los servicios estén funcionando:
docker compose ps
Problemas específicos de Windows
Errores de Turbopack en Windows:
# Use WSL2 for better compatibility
wsl --install
# Or disable Turbopack in package.json
# Change "next dev --turbopack" to "next dev"Problemas de fin de línea:
# Configure git to use LF
git config --global core.autocrlf inputVer registros
# All services
docker compose logs -f
# Specific service
docker compose logs -f simstudio