Troubleshooting

Common issues and their solutions when running Changemaker Lite.

Under Construction

This troubleshooting guide is being expanded. Check back soon for more solutions.

CORS Errors in Production

Symptom: Browser console shows CORS errors when accessing production domain.

Fix: Add your production domain to CORS_ORIGINS in .env:

CORS_ORIGINS=https://app.yourdomain.org,http://localhost:3000

Then restart the API: docker compose restart api

Pangolin Tunnel 403/302 Errors

Symptom: All API endpoints return 302 redirects to Pangolin auth page.

Fix: In the Pangolin dashboard, set each resource to "Not Protected" (public access).

Database Connection Failures

1. Check PostgreSQL: docker compose ps v2-postgres
2. Verify DATABASE_URL in .env
3. View logs: docker compose logs v2-postgres --tail 50

Redis Connection Failures

1. Check Redis: docker compose ps redis-changemaker
2. Verify REDIS_PASSWORD and REDIS_URL format in .env
3. Test: docker compose exec redis-changemaker redis-cli -a $REDIS_PASSWORD ping

API Not Starting

1. Check logs: docker compose logs api --tail 100
2. Verify all required env vars are set (see .env.example)
3. Run migrations: docker compose exec api npx prisma migrate deploy