---
title: "Chrome Dependency · Unlighthouse"
meta:
  "og:description": "Configure Chrome browser settings for Unlighthouse scanning, including system Chrome usage and custom installations."
  "og:title": "Chrome Dependency · Unlighthouse"
  description: "Configure Chrome browser settings for Unlighthouse scanning, including system Chrome usage and custom installations."
---

**Guides**

# **Chrome Dependency**

[Copy for LLMs](https://unlighthouse.dev/guide/guides/chrome-dependency.md)

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

## [Disabling system Chrome](#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](#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](#using-your-own-chrome-path)

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

```
export default defineUnlighthouseConfig({
  puppeteerOptions: {
    executablePath: '/usr/bin/chrome',
  },
})
```

[Edit this page](https://github.com/harlan-zw/unlighthouse/edit/main/docs/1.guide/guides/chrome-dependency.md)

[Markdown For LLMs](https://unlighthouse.dev/guide/guides/chrome-dependency.md)

**Did this page help you? **

Anything that could be done better? :)

Help us improve this page. You can [edit this page](https://github.com/harlan-zw/unlighthouse/edit/main/docs/1.guide/guides/chrome-dependency.md) on GitHub or provide anonymous feedback below.

[**Authentication** Scan password-protected websites with Unlighthouse. Configure basic auth, cookies, headers, localStorage, and programmatic login flows.](https://unlighthouse.dev/guide/guides/authentication) [**Common Errors** Troubleshoot common issues encountered when running Unlighthouse scans, including browser connection and environment problems.](https://unlighthouse.dev/guide/guides/common-errors)

**On this page **

- [Disabling system Chrome](#disabling-system-chrome)
- [Customizing the fallback installer](#customizing-the-fallback-installer)
- [Using your own chrome path](#using-your-own-chrome-path)