Troubleshooting

Common issues and solutions for SynapseAI.

Backend Issues

Backend won't start

• Check that Redis is running
• Verify environment variables are set correctly
• Check port 8001 is available

Frontend Issues

Frontend won't connect to backend

• Verify backend is running on port 8001
• Check CORS configuration
• Verify API endpoint URLs

General Issues

Build errors

• Clear node_modules and reinstall
• Check Node.js version (18+)
• Verify all dependencies are installed

Getting Help

• Check the Architecture documentation
• Review Backend Setup and Frontend Setup