Sim

Dépannage

Problèmes courants et solutions

Échec de connexion à la base de données

# Check database is running
docker compose ps db

# Test connection
docker compose exec db psql -U postgres -c "SELECT 1"

Vérifiez le format de DATABASE_URL : postgresql://user:pass@host:5432/database

Les modèles Ollama ne s'affichent pas

Dans Docker, localhost = le conteneur, pas votre machine hôte.

# 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/Temps réel ne fonctionne pas

  1. Vérifiez que NEXT_PUBLIC_SOCKET_URL correspond à votre domaine
  2. Vérifiez que le service temps réel est en cours d'exécution : docker compose ps realtime
  3. Assurez-vous que le proxy inverse transmet les mises à niveau WebSocket (voir Guide Docker)

Erreur 502 Bad Gateway

# Check app is running
docker compose ps simstudio
docker compose logs simstudio

# Common causes: out of memory, database not ready

Erreurs de migration

# View migration logs
docker compose logs migrations

# Run manually
docker compose exec simstudio bun run db:migrate

pgvector introuvable

Utilisez l'image PostgreSQL correcte :

image: pgvector/pgvector:pg17  # NOT postgres:17

Erreurs de certificat (CERT_HAS_EXPIRED)

Si vous voyez des erreurs de certificat SSL lors de l'appel d'API externes :

# 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=0

Page blanche après connexion

  1. Vérifiez la console du navigateur pour les erreurs
  2. Vérifiez que NEXT_PUBLIC_APP_URL correspond à votre domaine réel
  3. Effacez les cookies et le stockage local du navigateur
  4. Vérifiez que tous les services sont en cours d'exécution : docker compose ps

Problèmes spécifiques à Windows

Erreurs Turbopack sur Windows :

# Use WSL2 for better compatibility
wsl --install

# Or disable Turbopack in package.json
# Change "next dev --turbopack" to "next dev"

Problèmes de fin de ligne :

# Configure git to use LF
git config --global core.autocrlf input

Consulter les journaux

# All services
docker compose logs -f

# Specific service
docker compose logs -f simstudio

Obtenir de l'aide

On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started