Troubleshooting by error code
Find fixes quickly by error code or message.
Last updated: 2026-03-17
Last reviewed by: Compliance team
Use this page to match a Forgeon error string to a clear fix.
Severity legend
S1 — blockingS2 — degradedS3 — non‑blocking
Top 10 errors (auto‑generated)
Top errors will appear here after logs are processed.
Generated from logs via pnpm docs:top-errors.
| Severity | Error | Where it appears | Meaning | Fix |
|---|---|---|---|---|
| S1 | missing required environment variables | Deploy modal / runner logs | No env vars for selected environment | Add env vars in Settings → Environments, then redeploy |
| S1 | forbidden/quota_exceeded | Runtime start / build | Plan limit exceeded | Reduce usage or upgrade plan; re‑deploy |
| S1 | database clusters are available on Pro and Enterprise plans only | DB provisioning | Plan not eligible | Upgrade plan or remove DB bundle |
| S1 | runtime not reachable / 502 | Domains / preview URL | App not listening on expected port | Bind to 0.0.0.0 and use PORT env |
| S2 | domain mismatch: not owned by project | Runtime start | Domain not attached to this project/env | Check Domains tab and environment mapping |
| S2 | marketplace_entitlement_required | Marketplace deploy | Paid listing requires purchase | Complete checkout to gain entitlement |
| S2 | no source revision available for re‑analysis | Build & Deployment | No git revision available | Reconnect repo or re‑import project |
| S2 | buildpack does not support stack | Buildpacks build | Buildpack stack mismatch | Use matching builder or update buildpack image |
| S2 | Invalid token format | MDX agent metrics | Auth header missing Bearer token | Ensure agent token is set and sent as Bearer |
| S2 | No roles found in token | MDX metrics push | Token lacks required roles | Use a valid admin token for internal metrics |
| S2 | metrics push status 400: Engine has an invalid value | MDX agent metrics | Engine not allowed for metrics | Enable engine in metrics allowlist or update engine mapping |
| S2 | a deployment already exists for this commit | Deploy action | Duplicate deploy request | Use redeploy or pick a new commit |
| S2 | Plan not found or is inactive | DB provisioning | Plan ID missing or disabled | Use active plan or enable in Easy‑Forge |
| S2 | Marketplace resolve failed: code=404 | Deploy preview | Listing not found or invalid app id | Verify marketplace_app_id and listing status |
| S2 | Cannot find module 'pg' | Runtime (Node + Postgres) | DB driver missing | Add pg dependency or use buildpacks with driver |
| S2 | The server does not support SSL connections | Runtime DB connect | SSL required but server not configured | Use sslmode=disable for local/dev or enable SSL |
| S2 | Missing admin.auth.secret configuration | Strapi runtime | Admin secret not set | Set ADMIN_JWT_SECRET and restart |
| S3 | Failed to parse query parameters | Admin APIs | Invalid limit or missing required param | Check request params, ensure limit ≤ 100 |
| S3 | Re-analysis unavailable | Project settings | No source revision available | Reconnect repo or re‑import project |
| S3 | Maximum update depth exceeded | UI | State loop in React | Reload page; if persistent, report to support |
| S3 | Cannot access 'reviewOpen' before initialization | Deploy modal | State used before init | Reload; if persistent, report to support |
If you need a new error documented, add it here with the exact message text.