Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
112 lines (77 loc) · 2.27 KB

TROUBLESHOOTING.md

File metadata and controls

112 lines (77 loc) · 2.27 KB

Troubleshooting Guide

🚨 Common Issues and Solutions

1. Reddit API Credentials Error

Error: "Failed to start analysis. Please check your Reddit API credentials."

Solution:

  1. Verify your .env file has correct credentials: 
    cat .env
  2. Make sure there are no extra spaces around = signs
  3. Restart Docker after changing .env: 
    docker-compose down
docker-compose up --build

2. Docker Not Running

Error: "Cannot connect to the Docker daemon"

Solution:

  1. Start Docker Desktop
  2. Wait for Docker to fully start (whale icon in menu bar)
  3. Try again: docker-compose up --build

3. Dashboard Data Error

Error: "Failed to fetch dashboard data"

Solution:

  1. Check if backend is running: curl http://localhost:8000/health
  2. Restart services: docker-compose down && docker-compose up --build
  3. Wait for all services to show "ready" messages

4. Port Conflicts

Error: Port 3000 or 8000 already in use

Solution:

  1. Stop other applications using these ports
  2. Or modify docker-compose.yml to use different ports

5. Memory Issues

Error: Application crashes or runs slowly

Solution:

  1. Ensure at least 2GB RAM available
  2. Close other applications
  3. Restart Docker Desktop

🔧 Quick Fixes

Reset Everything

# Stop all services
docker-compose down -v

# Remove all containers and images
docker system prune -a

# Restart fresh
docker-compose up --build

Check Logs

# Backend logs
docker-compose logs backend

# Frontend logs
docker-compose logs frontend

# All logs
docker-compose logs

Test API Connection

# Health check
curl http://localhost:8000/health

# API docs
open http://localhost:8000/docs

📞 Getting Help

If you're still having issues:

  1. Check the logs for specific error messages
  2. Verify your Reddit API credentials are correct
  3. Ensure Docker Desktop is running
  4. Try the reset procedure above

✅ Success Indicators

Your application is working correctly when you see:

  • ✅ Backend: INFO: Application startup complete.
  • ✅ Frontend: webpack compiled successfully
  • ✅ Redis: Ready to accept connections
  • ✅ Dashboard loads at http://localhost:3000
  • ✅ Analysis works without errors