Source code
Revision control
Copy as Markdown
Other Tools
# Running a performance test
## Running locally
Running a test is as simple as calling it using `mach perftest` in a mozilla-central source
checkout:
```
$ ./mach perftest
```
The `mach` command will bootstrap the installation of all required tools for the
framework to run, and display a selection screen to pick a test. Once the
selection is done, the performance test will run locally.
If you know what test you want to run, you can use its path explicitly:
```
$ ./mach perftest perftest_script.js
```
`mach perftest` comes with numerous options, and the test script should provide
decent defaults, so you don't need to adjust them. If you need to tweak some
options, you can use `./mach perftest --help` to learn about them.
## Running in the CI
:::{warning}
If you are looking for how to run performance tests in CI and ended up here,
you should check out {ref}`Mach Try Perf`.
:::