Solução de problemas

Falha na conexão com o banco

# Verifique se o banco está rodando
docker compose ps db

# Teste a conexão
docker compose exec db psql -U postgres -c "SELECT 1"

Verifique o formato de DATABASE_URL: postgresql://user:pass@host:5432/database

Modelos do Ollama não aparecem

Dentro do Docker, localhost = o container, não a sua máquina host.

# Para Ollama na máquina host, use:
OLLAMA_URL=http://host.docker.internal:11434  # macOS/Windows
OLLAMA_URL=http://192.168.1.x:11434           # Linux (use o IP real)

WebSocket/Realtime não funciona

Verifique se o reverse proxy roteia /socket.io para o serviço realtime (porta padrão 3002). NEXT_PUBLIC_SOCKET_URL só é necessário se o realtime estiver em um host separado.
Verifique se o serviço realtime está rodando: docker compose ps realtime
Garanta que o reverse proxy passa upgrades de WebSocket (veja o guia de Docker)

502 Bad Gateway

# Verifique se o app está rodando
docker compose ps simstudio
docker compose logs simstudio

# Causas comuns: falta de memória, banco ainda não pronto

Erros de migration

# Veja os logs de migration
docker compose logs migrations

# Rode manualmente
docker compose exec simstudio bun run db:migrate

pgvector não encontrado

Use a imagem correta do PostgreSQL:

image: pgvector/pgvector:pg17  # NÃO postgres:17

Erros de certificado (CERT_HAS_EXPIRED)

Se você vir erros de certificado SSL ao chamar APIs externas:

# Atualize os certificados CA no container
docker compose exec simstudio apt-get update && apt-get install -y ca-certificates

# Ou defina no ambiente (não recomendado em produção)
NODE_TLS_REJECT_UNAUTHORIZED=0

Verifique o console do navegador por erros
Confirme que NEXT_PUBLIC_APP_URL corresponde ao seu domínio real
Limpe cookies e local storage do navegador
Verifique se todos os serviços estão rodando: docker compose ps

Problemas específicos do Windows

Erros de Turbopack no Windows:

# Use WSL2 para melhor compatibilidade
wsl --install

# Ou desative o Turbopack no package.json
# Mude "next dev --turbopack" para "next dev"

Problemas de fim de linha:

# Configure o git para usar LF
git config --global core.autocrlf input

Ver logs

# Todos os serviços
docker compose logs -f

# Serviço específico
docker compose logs -f simstudio