# 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`.
:::
