> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testbrick.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Running Tests

> Execute tests in the cloud or locally

# Running Tests

TestBrick supports two execution modes: cloud and local.

## Cloud execution

Click **Run Test** to execute in the cloud. TestBrick spins up a browser on its servers, runs every step, and returns the results with screenshots and video.

* Uses your monthly test run credits
* No setup required
* Runs in a consistent environment

## Local agent

The TestBrick local agent runs tests on your own machine for free.

### Install

```bash theme={null}
npm install -g testbrick-agent
```

### Connect

```bash theme={null}
testbrick-agent start
```

The agent connects to your TestBrick account via WebSocket. When connected, the dashboard shows "Agent Connected" and tests automatically route to your machine.

### Benefits

* **Free** — no test run credits used
* **Fast** — runs on your local machine, no cloud latency
* **Access local servers** — test against `localhost` or internal URLs

## Test results

After a run completes, you see:

* **Step-by-step results** — pass/fail status per step
* **Screenshots** — captured after each step
* **Video recording** — full replay of the test (cloud only)
* **Console errors** — any JavaScript errors during the test
* **Network requests** — all API calls made during the test

## Test duration limits

| Plan  | Max duration |
| ----- | ------------ |
| Free  | 5 minutes    |
| Pro   | 15 minutes   |
| Team+ | 30 minutes   |

If a test exceeds the time limit, remaining steps are skipped with a clear "exceeded maximum duration" message.