Solutions for frequently encountered issues when running Unlighthouse scans. Ensure you're using the latest version before troubleshooting.

connect ECONNREFUSED 127.0.0.1:<port>

Example

Error: Unable to launch browser for worker, error message: connect ECONNREFUSED 127.0.0.1:51667

This error is thrown when Chromium is unable to launch. This happens when puppeteer is unable to connect to the browser. This can be from a number of reasons:

• The environment is not configured correctly, likely when using Windows and WSL.
• You have a firewall or antivirus blocking Chrome or Chromium from launching or connecting to the required port.
• You are using an unsupported version of Chrome or Chromium.

Windows and WSL Solution

• Install Puppeteer on WSL following the documentation.
• Install Chrome in WSL following the documentation.

Other Environments

• You can try disabling the system Chrome, instead using the fallback.

import { defineUnlighthouseConfig } from 'unlighthouse/config'

export default defineUnlighthouseConfig({
  chrome: {
    useSystem: false,
  },
})