Skip to main content
ReportForge

More

Troubleshooting

Solutions to common issues. Enable debug logging first; it shows exactly which step failed.

Enable debug logging

Set RF_DEBUG=1 to print verbose output from the reporter, including Chrome launch args, license check results, and PDF write path.

# Linux / macOSRF_DEBUG=1 npx playwright test# Windows (PowerShell)$env:RF_DEBUG = "1"; npx playwright test# Windows (Command Prompt)set RF_DEBUG=1 && npx playwright test

Debug output goes to stderr and is separate from Playwright's own output.

PDF not generated: no error

If the run completes but no PDF appears and no error is shown, the reporter skipped PDF generation silently. Common causes:

  • Missing license key. Check that RF_LICENSE_KEY is set in the current environment. Run with RF_DEBUG=1 to confirm the key is read.
  • Reporter not in config. Confirm @reportforge/playwright-pdf is listed in your reporter array in playwright.config.ts.
  • Wrong working directory. The outputFile path is relative to where you run npx playwright test, not where the config lives.

Chrome not found

The reporter looks for Chrome in this order: PUPPETEER_EXECUTABLE_PATH env → system Chrome via chrome-finder → puppeteerExecutablePath config option.

Set the path explicitly to bypass auto-detection:

# Linux CIexport PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome-stable# macOSexport PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"# Windows (PowerShell)$env:PUPPETEER_EXECUTABLE_PATH = "C:\Program Files\Google\Chrome\Application\chrome.exe"

See Running tests for full OS-specific installation instructions.

License errors

Invalid key format

The key does not match the RFSU-XXXX-XXXX-XXXX-XXXX pattern. Copy it exactly from your dashboard or the welcome email.

Machine cap exceeded (25 machines)

Your subscription allows up to 25 active machines per rolling 30-day window. Machines that have not run tests in 30 days are evicted automatically. You can also remove individual machines from the Machines tab.

Subscription inactive

Your trial has ended or your subscription is past due. Visit the Billing tab to update your payment method.

PDF too large

The reporter caps PDF size at maxFileSizeMb (default 8 MB) by compressing screenshots. If you need a higher cap:

reporter: [['@reportforge/playwright-pdf', {  maxFileSizeMb: 20,}]]

Alternatively, switch to the minimal or executive template which omit screenshots entirely.

Chromium snap (Ubuntu / Linux)

Do not install chromium-browser on Ubuntu; it installs as a snap and Puppeteer cannot drive it due to sandboxing restrictions.

Always install google-chrome-stable from Google's APT repository:

wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | \  sudo gpg --dearmor -o /usr/share/keyrings/google-chrome.gpgecho "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] \  http://dl.google.com/linux/chrome/deb/ stable main" | \  sudo tee /etc/apt/sources.list.d/google-chrome.listsudo apt-get update -qq && sudo apt-get install -y google-chrome-stableexport PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome-stable

Still stuck? Open a support ticket and include the output of RF_DEBUG=1 npx playwright test.