fix: bootstrap Docker startup and repair sidebar load metric

Run Prisma migrations automatically before the API boots in Docker, avoid the misleading missing-.env warning when the container already has injected environment variables, and document that Docker users no longer need manual database bootstrap commands.

Also route the dashboard proxy through an internal API URL for container networking and switch the sidebar system load widget to a real host memory-based metric from the API.

Author: saifyxpro

README.md

@@ -285,6 +285,7 @@ docker compose -f infra/docker/docker-compose.yml up -d
 ```
 
 The Docker stack now requires `DASHBOARD_INTERNAL_API_KEY` and `CREDENTIAL_ENCRYPTION_KEY` in `.env`. The API will refuse to boot without them.
+The API container now applies Prisma migrations automatically on startup, so you do not need to run manual `pnpm db:*` commands for the Docker workflow.
 
 ### 6️⃣ Access the Application
 

apps/api/src/controllers/DashboardController.ts

@@ -1,4 +1,5 @@
 import { Request, Response } from 'express';
+import os from 'os';
 import { prisma } from '../database/client';
 import { configService } from '../services/ConfigService';
 import { browserService } from '../services/BrowserService';
@@ -27,6 +28,11 @@ export class DashboardController {
 
             const browserStatus = browserService.getStatus();
             const runningBrowsersCount = browserStatus.default ? 1 : 0;
+            const totalMemory = os.totalmem();
+            const usedMemory = totalMemory - os.freemem();
+            const memoryLoadPercent = totalMemory > 0
+                ? Math.round((usedMemory / totalMemory) * 100)
+                : 0;
 
             // Calculate success rate
             const failedRateVal = totalJobs > 0
@@ -44,7 +50,8 @@ export class DashboardController {
                 runningBrowsers: runningBrowsersCount,
                 maxConcurrency: config.maxConcurrency,
                 browserHeadless: config.browserHeadless,
-                proxyEnabled: config.proxyEnabled
+                proxyEnabled: config.proxyEnabled,
+                systemLoad: memoryLoadPercent
             });
         } catch (error) {
             console.error('Dashboard Stats Error:', error);

apps/api/src/env.ts

@@ -1,4 +1,5 @@
 import path from 'path';
+import fs from 'fs';
 import dotenv from 'dotenv';
 import { fileURLToPath } from 'url';
 
@@ -7,10 +8,24 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 const envPath = path.resolve(__dirname, '..', '..', '..', '.env');
-const result = dotenv.config({ path: envPath });
+const hasEnvFile = fs.existsSync(envPath);
 
-if (result.error) {
-    console.warn(`⚠️ Could not load .env from ${envPath}`);
+if (hasEnvFile) {
+    const result = dotenv.config({ path: envPath });
+
+    if (result.error) {
+        console.warn(`⚠️ Could not load .env from ${envPath}`);
+    } else {
+        console.log(`✅ Loaded environment from ${envPath}`);
+    }
 } else {
-    console.log(`✅ Loaded environment from ${envPath}`);
+    const hasInjectedEnv = Boolean(
+        process.env.DATABASE_URL ||
+        process.env.DASHBOARD_INTERNAL_API_KEY ||
+        process.env.CREDENTIAL_ENCRYPTION_KEY
+    );
+
+    if (!hasInjectedEnv) {
+        console.warn(`⚠️ Could not load .env from ${envPath}`);
+    }
 }

apps/web/src/app/api/[...path]/route.ts

@@ -1,6 +1,6 @@
 import { NextRequest } from 'next/server';
 
-const backendApiUrl = process.env.NEXT_PUBLIC_API_URL || 'http://localhost:8000';
+const backendApiUrl = process.env.INTERNAL_API_URL || process.env.NEXT_PUBLIC_API_URL || 'http://localhost:8000';
 const dashboardInternalApiKey = process.env.DASHBOARD_INTERNAL_API_KEY;
 
 export const dynamic = 'force-dynamic';

apps/web/src/components/dashboard/Sidebar.tsx

@@ -41,17 +41,15 @@ export function Sidebar() {
         queryFn: async () => {
             const res = await fetch('/api/dashboard/stats');
             if (!res.ok) {
-                return { runningBrowsers: 0, maxConcurrency: 0 };
+                return { systemLoad: 0 };
             }
-            return res.json().catch(() => ({ runningBrowsers: 0, maxConcurrency: 0 }));
+            return res.json().catch(() => ({ systemLoad: 0 }));
         },
         refetchInterval: 5000,
         refetchOnWindowFocus: false,
     });
 
-    const systemLoad = systemStats?.maxConcurrency
-        ? Math.min(100, Math.round(((systemStats.runningBrowsers || 0) / systemStats.maxConcurrency) * 100))
-        : 0;
+    const systemLoad = Math.max(0, Math.min(100, Number(systemStats?.systemLoad) || 0));
 
     return (
         <aside

docs/docker_setup.md

@@ -21,6 +21,7 @@ This will start:
 3. **HeadlessX Web Dashboard** (Port `3000`)
 
 You can access the dashboard at [http://localhost:3000](http://localhost:3000).
+The API container automatically runs `prisma migrate deploy` before booting, so Docker users do not need to apply database migrations manually.
 
 ## Configuration
 

infra/docker/api-entrypoint.sh

@@ -0,0 +1,23 @@
+#!/bin/sh
+set -eu
+
+cd /app/apps/api
+
+MAX_ATTEMPTS="${PRISMA_MIGRATE_MAX_ATTEMPTS:-10}"
+ATTEMPT=1
+
+echo "🗄️ Applying Prisma migrations..."
+
+until pnpm exec prisma migrate deploy; do
+    if [ "$ATTEMPT" -ge "$MAX_ATTEMPTS" ]; then
+        echo "❌ Prisma migration failed after ${MAX_ATTEMPTS} attempts."
+        exit 1
+    fi
+
+    echo "⚠️ Prisma migration attempt ${ATTEMPT} failed. Retrying in 3 seconds..."
+    ATTEMPT=$((ATTEMPT + 1))
+    sleep 3
+done
+
+echo "✅ Prisma migrations applied."
+exec pnpm exec tsx src/server_entry.ts

infra/docker/api.Dockerfile

@@ -34,6 +34,7 @@ COPY nx.json ./
 
 # Copy API app
 COPY apps/api ./apps/api
+COPY infra/docker/api-entrypoint.sh /usr/local/bin/headlessx-api-entrypoint
 
 # Install dependencies
 RUN pnpm install --frozen-lockfile
@@ -49,4 +50,5 @@ RUN pnpm exec nx run headlessx-api:build
 
 # Start the API
 WORKDIR /app/apps/api
-CMD ["pnpm", "start"]
+RUN chmod +x /usr/local/bin/headlessx-api-entrypoint
+CMD ["/usr/local/bin/headlessx-api-entrypoint"]

infra/docker/docker-compose.yml

@@ -52,6 +52,7 @@ services:
     depends_on:
       - api
     environment:
+      - INTERNAL_API_URL=http://api:${PORT:-8000}
       - NEXT_PUBLIC_API_URL=http://localhost:${PORT:-8000}
       - NODE_ENV=production
       - DASHBOARD_INTERNAL_API_KEY=${DASHBOARD_INTERNAL_API_KEY}