Troubleshooting

Services Won't Start

Solution:

# Check logs
docker compose logs

# Verify Docker is running
docker ps

# Check port availability
netstat -an | grep -E '3000|8000|5432'

Database Connection Errors

Solution:

• Verify DATABASE_URL is correct in .env
• Check PostgreSQL container is running: docker compose ps
• Verify database credentials
• Check network connectivity between containers

Model API Errors

Solution:

• Verify API keys are correct and have sufficient credits
• Check network connectivity to model providers
• Review API rate limits
• Check logs for specific error messages

Sessions Not Starting

Solution:

• Check API logs for errors
• Verify Agents/Knights are configured correctly
• Ensure model API keys are valid
• Check database for session records

High Memory Usage

Solution:

• Increase Docker memory limits
• Reduce concurrent sessions
• Use lighter models for some Agents
• Monitor with docker stats