Skip to content


Captcha issues

Option 1

If you're running into problems, try running in headful mode: HEADLESS="false".

This will open a browser and run streetmerchant. Note that this isn't a great solution for those running in a headless environment, i.e.: VPS, cloud, docker. Instead, it would be a good solution for those running on separate computer that won't be blocked by running in the background.

Option 2

As a last case scenario, use PUPPETEER_EXECUTABLE_PATH. This will use your computer's Chrome browser. You can run this is headless or headful mode.

From the puppeteer doc:

PUPPETEER_EXECUTABLE_PATH - specify an executable path to be used in puppeteer.launch. See puppeteer.launch([options]) on how the executable path is inferred. BEWARE: Puppeteer is only guaranteed to work with the bundled Chromium, use at your own risk.

For example:



This will vary depending on your operating system and install path. Please use full paths.

macOS code signing

If you're getting a popup like this:


Then run this command:

sudo codesign --force --deep --sign - ./node_modules/puppeteer/.local-chromium/mac-800071/chrome-mac/

The mac-800071 may be different on your machine, so I would start from ./node_modules/puppeteer/.local-chromium and auto complete from there.

Last update: 2021-02-27