demo not loading

[S1LV3R108]

System health check unavailable (backend may need restart)
what to do for this ?
and whenever i press load demo data this pops up
An unexpected error occurred. Please try again later.
pls help

[chadfryer]

Troubleshooting Guide

These errors indicate the backend services are not fully running or accessible. Here's how to diagnose and fix:

Step 1: Check if all services are running

docker compose ps

You should see all services with status Up. If any show Exited or restarting, that's the issue.

Step 2: View logs for the controls service

The demo data API is served by the grc-controls service:

docker compose logs grc-controls --tail=50

Look for:

• Database connection errors
• Prisma migration issues
• Port binding conflicts

Step 3: Restart the backend services

docker compose down
docker compose up -d

Wait ~30 seconds for all services to initialize, then try again.

Step 4: Verify the API is responding

curl http://localhost:3001/health

If this returns {"status":"healthy"}, the backend is working.

Common Causes

1. Database not ready - The Postgres container may still be initializing when the app tries to connect
2. Port conflicts - Another process using port 3001 or 5432
3. First-time setup - Database migrations may not have run yet
4. Docker resource limits - Increase Docker's memory allocation if containers are OOM-killed

New Documentation Available

We've added a comprehensive Demo Data Guide with detailed troubleshooting steps. Check the Troubleshooting section for more help.

Let us know the output of the commands above and we can help diagnose further!