Common Issues
Database connection fails
Error: ECONNREFUSED 127.0.0.1:5432
Solution:
- • Ensure PostgreSQL is running:
docker-compose ps - • Check DATABASE_URL in .env
- • Verify database exists:
docker-compose exec db psql -U user -l
API key errors
Error: 401 Unauthorized
Solution:
- • Verify OPENAI_API_KEY and CLAUDE_API_KEY are set in .env
- • Ensure keys are valid and have not expired
- • Check for extra spaces or quotes around keys
Port already in use
Error: EADDRINUSE :::3000
Solution:
- • Change PORT in .env to a different value (e.g., 3001)
- • Or kill the process using port 3000:
lsof -ti:3000 | xargs kill -9
Still stuck?
Join our Discord community for real-time help from the team and other users.
Join Discord