npm install -g lighthouse
To run an audit:
lighthouse <url>
To see all the options:
lighthouse --help
Run the Node module programmatically
See Using programmatically
for an example of running Lighthouse programmatically, as a Node module.
Run PageSpeed Insights
To run Lighthouse on PageSpeed Insights:
Go to PageSpeed Insights.
Enter a web page URL.
Click Analyze.
Run Lighthouse as a Chrome Extension

To install the extension:
Download Google Chrome for Desktop.
Install the Lighthouse Chrome Extension from the Chrome Webstore.
To run an audit:
In Chrome, go to the page you want to audit.
Click 
Lighthouse, next to the Chrome address bar or in Chrome's extension menu.
Once clicked, the Lighthouse menu expands.
Share reports as JSON
The Lighthouse Viewer needs the JSON output of a Lighthouse report. Generate
the JSON outputs as follows:
From a Lighthouse report. Click more_vert
for the menu, then click  Save as JSON
Command line. Run:
shell
lighthouse --output json --output-path <path/for/output.json>
To view the report data:
Open the Lighthouse Viewer.
Drag the JSON file onto the Viewer, or click anywhere in the Viewer to open
your file navigator and select the file.
Share reports as GitHub Gists
If you don't want to manually pass around JSON files, you can also share your
reports as secret GitHub gists. One benefit of gists is free version control.
To export a report as a gist from the report:
Click the more_vert menu, then click
Open In Viewer. The report is located at
https://googlechrome.github.io/lighthouse/viewer/.
From the Viewer, click more_vert menu,
then click
Save as Gist. The first time you do this, a popup asks permission to
access your basic GitHub data, and to read and write to your gists.
To export a report as a gist from the CLI version of Lighthouse,
manually create a gist and copy-paste the report's
JSON output into the gist. The gist filename containing the JSON output must
end in .lighthouse.report.json. See Share reports as JSON for an
example of how to generate JSON output from the command line tool.
To view a report that's been saved as a gist:
Add ?gist=<ID> to the Viewer's URL, where <ID> is the ID of the gist.
https://googlechrome.github.io/lighthouse/viewer/?gist=<ID>
Open the Viewer, and
paste the URL of a gist into it.
Lighthouse extensibility
Lighthouse aims to provide guidance that is relevant and actionable for all web
developers. To this end, there are two features available that allow you to
tailor Lighthouse to your specific needs.
Stack packs
Developers use many different technologies (backend, content management systems,
and JavaScript frameworks) to build their web pages. Instead of surfacing
general recommendations, Lighthouse provides relevant and actionable advice,
depending on the tools used.
Stack packs allow Lighthouse to detect what platform your site is built on
and display specific stack-based recommendations. These recommendations are
defined and curated by experts from the community.
To contribute a stack pack, review the
Contributing Guidelines.
Lighthouse plugins
Lighthouse plugins allow domain experts to extend the functionality of
Lighthouse for their community's specific needs. You can leverage
the data that Lighthouse collects to create new audits. At its core, a
Lighthouse plugin is a node module that implements a set of checks to be run by
Lighthouse and added to the report as a new category.
For more information about how to create your own plugin, check out our
Plugin Handbook
in the Lighthouse GitHub repo.
Integrate Lighthouse
If you're a company or an individual who is integrating Lighthouse as part of
the products or services you're offering, that's great! We want as many people
as possible to use Lighthouse.
Refer to the
Guidelines and Brand Assets for Integrating Lighthouse
to show that Lighthouse is used, while protecting our brand.
Contribute to Lighthouse
Lighthouse is open source and
contributions are welcome!
Check out the repository's
Issue tracker to find
bugs that you can fix,
or audits that you can create or improve upon. The Issues are a good place to
discuss performance metrics, ideas for new audits, or anything else related to
Lighthouse.
  
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
  
Last updated 2025-06-02 UTC.
      [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-02 UTC."],[],[]]