How to setup up mermaid to use already installed chromium?

[habdank]

Hi!

We have installed by corporate platform Chromium based browser.
Due to security policies, no other browser is allowed.

Therefore starting mermaid-cli I am getting the following error:

Error: spawn EPERM
    at ChildProcess.spawn (internal/child_process.js:403:11)
    at Object.spawn (child_process.js:553:9)
    at BrowserRunner.start (C:\Data\Tools\mermaid\node_modules\puppeteer\lib\cjs\puppeteer\node\BrowserRunner.js:116:34)
    at ChromeLauncher.launch (C:\Data\Tools\mermaid\node_modules\puppeteer\lib\cjs\puppeteer\node\Launcher.js:117:16)

Is it possible to configure mermaid-cli to use other (pre-installed) chromium?

Thanks in advance for help.

[aloisklink]

Yes, it should be possible on Linux/MacOS, although I've got no idea if it will work on Windows.

If you run mermaid-cli with the --help flag, there's an option for --puppeteerConfigFile, which is a JSON configuration file for puppeteer.

These are options passed to puppeteer.launch.

The useful options for you are:

• executablePath Path to a browser executable to use instead of the bundled Chromium. Note that Puppeteer is only guaranteed to work with the bundled Chromium, so use this setting at your own risk. You may find https://github.com/puppeteer/puppeteer/blob/main/versions.js useful to see which versions of Chrome are compatible with versions of puppeteer.
• product (in case you want to use firefox instead of chrome)
• timeout can be used to increase/decrease timeout before puppeteer throws an error

You'll probably want a file called puppeteerConfigFile.json with contents:

{
  "executablePath": "C:\\path\\to\\your\\chrome.exe"
}

Then run mermaid-cli with option mmdc --puppeteerConfigFile puppeteerConfigFile.json.

You might also be able to do the same thing with environment variables by following: https://pptr.dev/#environment-variables.

Btw, if you set PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=1 as an env variable when running yarn install or npm install, it should skip downloading CHROMIUM too.

[MindaugasLaganeckas]

@habdank : if you can confirm the solution above, then we will create a section in our docs for it.