# Download TestOwl

> Download the TestOwl desktop app for macOS, Windows, or Linux (Intel/x64 and ARM64 builds for every platform), or skip installation entirely and get started with TestOwl directly in your browser.

## Available Downloads

- **macOS** — Apple Silicon (ARM64) and Intel (x64) builds
- **Windows** — x64 and ARM64 builds
- **Linux** — x64 and ARM64 AppImage builds

## What the Desktop App Is For

The desktop app is the same TestOwl you use in the browser — same account, projects and tests — plus recording tests in a real browser and running tests locally on your own machine. Building and editing tests, cloud runs, schedules and reports also work in the web app, so you only need the desktop app to record or run locally.

## System Requirements

| Platform | Minimum version | Processors | Installer |
| --- | --- | --- | --- |
| macOS | macOS 12 (Monterey) or later | Apple Silicon and Intel | .dmg |
| Windows | Windows 10 (64-bit) or later | x64 and ARM64 | .exe installer |
| Linux | glibc >= 2.28 (e.g. Ubuntu 20.04+, Debian 11+, Fedora 36+) | x64 and ARM64 | .AppImage |

An internet connection is required. The first time you record or run locally, the app downloads the browser and video components it uses.

## How to Install

Every production installer is digitally signed by KRS Solutions LLP.

- **macOS** — open the .dmg, drag Testowl into Applications, then open it from Applications.
- **Windows** — run the .exe. If SmartScreen appears, click More info, confirm the publisher is KRS Solutions LLP, then Run anyway. See the [Windows install guide](https://testowl.ai/download/windows).
- **Linux** — make the AppImage executable (chmod +x), then run it. No system-wide install is needed.

## How to Sign In and Connect to a Project

Sign in with the same account you use at app.testowl.ai: email and password with a one-time code, or Google, GitHub or Microsoft sign-in, which opens in your web browser and returns you to the app. Projects, roles and plan are the same as on the web, so there is nothing separate to connect.

## How to Update

The app checks for and downloads updates in the background. When one is ready, click **Restart & Install** in the top bar.

## Troubleshooting a Failed Install

- **Windows protected your PC** — SmartScreen holds back new releases; click More info, then Run anyway.
- **Linux AppImage does nothing** — make it executable; some newer distributions also need libfuse2.
- **Recording or a local run will not start the first time** — check you are online so the app can download its browser components.
- **Record and Local are greyed out** — you are in a web browser; open the desktop app.

## No Installation Needed

You can build tests, run them in the cloud and read reports at [app.testowl.ai](https://app.testowl.ai) without installing anything. Recording and local runs need the desktop app.
