Guides

Chrome Dependency

Last updated by
Harlan Wilton
in doc: clean up.

Introduction

Unlighthouse automatically detects and uses your system's Chrome installation to keep package size minimal. When Chrome isn't available, it downloads a compatible Chromium binary as a fallback.

Disabling system Chrome

You can disable the system chrome usage by modifying the chrome.useSystem flag.

This will make Unlighthouse download and use the latest Chrome binary instead.

import { defineUnlighthouseConfig } from 'unlighthouse/config'

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

Customizing the fallback installer

When Chrome can't be found on your system or if the chrome.useSystem: false flag is passed, then a fallback will be attempted.

This fallback will download a chrome binary for your system and use that path.

There are a number of options you can customize on this.

  • chrome.useDownloadFallback - Disables the fallback installer
  • chrome.downloadFallbackVersion - Which version of chromium to use (default 1095492)
  • chrome.downloadFallbackCacheDir - Where the binary should be saved (default $home/.unlighthouse)
export default defineUnlighthouseConfig({
  chrome: {
    useDownloadFallback: true,
    downloadFallbackVersion: '1095492',
    downloadFallbackCacheDir: '/tmp/unlighthouse',
  },
})

Using your own chrome path

You can provide your own chrome path by setting puppeteerOptions.executablePath.

export default defineUnlighthouseConfig({
  puppeteerOptions: {
    executablePath: '/usr/bin/chrome',
  },
})
Did this page help you?