データベース接続に失敗
# Check database is running
docker compose ps db
# Test connection
docker compose exec db psql -U postgres -c "SELECT 1"DATABASE_URL 形式を確認してください: postgresql://user:pass@host:5432/database
Ollamaモデルが表示されない
Docker内では、localhost = ホストマシンではなく、コンテナを指します。
# 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/リアルタイム機能が動作しない
NEXT_PUBLIC_SOCKET_URLがドメインと一致しているか確認する- リアルタイムサービスが実行されているか確認する:
docker compose ps realtime - リバースプロキシがWebSocketアップグレードを通過させていることを確認する（Dockerガイドを参照）
502 Bad Gateway
# Check app is running
docker compose ps simstudio
docker compose logs simstudio
# Common causes: out of memory, database not readyマイグレーションエラー
# View migration logs
docker compose logs migrations
# Run manually
docker compose exec simstudio bun run db:migratepgvectorが見つからない
正しいPostgreSQLイメージを使用してください：
image: pgvector/pgvector:pg17 # NOT postgres:17証明書エラー（CERT_HAS_EXPIRED）
外部APIを呼び出す際にSSL証明書エラーが表示される場合：
# 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ログイン後の空白ページ
- ブラウザコンソールでエラーを確認する
NEXT_PUBLIC_APP_URLが実際のドメインと一致しているか確認する- ブラウザのCookieとローカルストレージをクリアする
- すべてのサービスが実行されているか確認する:
docker compose ps
Windows特有の問題
WindowsでのTurbopackエラー：
# Use WSL2 for better compatibility
wsl --install
# Or disable Turbopack in package.json
# Change "next dev --turbopack" to "next dev"改行の問題：
# Configure git to use LF
git config --global core.autocrlf inputログを表示
# All services
docker compose logs -f
# Specific service
docker compose logs -f simstudio