mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-11 07:04:58 -05:00
111 lines
2.3 KiB
Plaintext
111 lines
2.3 KiB
Plaintext
---
|
|
title: Troubleshooting
|
|
description: Common issues and solutions
|
|
---
|
|
|
|
## Database Connection Failed
|
|
|
|
```bash
|
|
# Check database is running
|
|
docker compose ps db
|
|
|
|
# Test connection
|
|
docker compose exec db psql -U postgres -c "SELECT 1"
|
|
```
|
|
|
|
Verify `DATABASE_URL` format: `postgresql://user:pass@host:5432/database`
|
|
|
|
## Ollama Models Not Showing
|
|
|
|
Inside Docker, `localhost` = the container, not your host machine.
|
|
|
|
```bash
|
|
# 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/Realtime Not Working
|
|
|
|
1. Check `NEXT_PUBLIC_SOCKET_URL` matches your domain
|
|
2. Verify realtime service is running: `docker compose ps realtime`
|
|
3. Ensure reverse proxy passes WebSocket upgrades (see [Docker guide](/self-hosting/docker))
|
|
|
|
## 502 Bad Gateway
|
|
|
|
```bash
|
|
# Check app is running
|
|
docker compose ps simstudio
|
|
docker compose logs simstudio
|
|
|
|
# Common causes: out of memory, database not ready
|
|
```
|
|
|
|
## Migration Errors
|
|
|
|
```bash
|
|
# View migration logs
|
|
docker compose logs migrations
|
|
|
|
# Run manually
|
|
docker compose exec simstudio bun run db:migrate
|
|
```
|
|
|
|
## pgvector Not Found
|
|
|
|
Use the correct PostgreSQL image:
|
|
```yaml
|
|
image: pgvector/pgvector:pg17 # NOT postgres:17
|
|
```
|
|
|
|
## Certificate Errors (CERT_HAS_EXPIRED)
|
|
|
|
If you see SSL certificate errors when calling external APIs:
|
|
|
|
```bash
|
|
# 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
|
|
```
|
|
|
|
## Blank Page After Login
|
|
|
|
1. Check browser console for errors
|
|
2. Verify `NEXT_PUBLIC_APP_URL` matches your actual domain
|
|
3. Clear browser cookies and local storage
|
|
4. Check that all services are running: `docker compose ps`
|
|
|
|
## Windows-Specific Issues
|
|
|
|
**Turbopack errors on Windows:**
|
|
```bash
|
|
# Use WSL2 for better compatibility
|
|
wsl --install
|
|
|
|
# Or disable Turbopack in package.json
|
|
# Change "next dev --turbopack" to "next dev"
|
|
```
|
|
|
|
**Line ending issues:**
|
|
```bash
|
|
# Configure git to use LF
|
|
git config --global core.autocrlf input
|
|
```
|
|
|
|
## View Logs
|
|
|
|
```bash
|
|
# All services
|
|
docker compose logs -f
|
|
|
|
# Specific service
|
|
docker compose logs -f simstudio
|
|
```
|
|
|
|
## Getting Help
|
|
|
|
- [GitHub Issues](https://github.com/simstudioai/sim/issues)
|
|
- [Discord](https://discord.gg/Hr4UWYEcTT)
|