# Installing builds

## Register test devices

Testers can register their devices from Runway's desktop site by navigating to **Profiles and devices** and selecting **Add a test device**. Runway provides the option to register devices via a QR code or manually. 

{% hint style="info" %}
The QR code device registration flow is currently supported on mobile devices using Chrome and Safari.
{% endhint %}

## Installing builds

Builds can be installed on a compatible mobile (iOS or Android) device either from the [Runway desktop site](#installing-a-build-from-the-runway-desktop-site), or by navigating to the Runway site on your mobile device’s browser. Note that on iOS, only `.ipa` builds are currently installable. 

Supported binary file types are:

* `.apk` 
* `.aab` 
* `.ipa` 

{% hint style="info" %}
Android AAB builds cannot be directly installed on Android devices by default. 
{% endhint %}

{% hint style="success" %}
Runway can automatically generate installable universal APKs from AABs being pulled into a bucket. To enable this functionality you must upload your app's signing key to Runway under [App settings > Signing keys](/using-runway/app-settings/signing-keys.md).
{% endhint %}

<div><figure><img src="/files/znuI0E0WrCA6J6RoedKL" alt=""><figcaption><p>List of builds in buckets</p></figcaption></figure> <figure><img src="/files/wfVMtP4N7l4vJ144FtUR" alt=""><figcaption><p>Bucket detail with installation action</p></figcaption></figure></div>

### Installing a build from the Runway desktop site

To install a build from the Runway desktop site, click one of the two options on the “Install” menu for the desired build:

* **Install on mobile device from QR code**: a QR code will be surfaced that you can scan with the camera app on your phone. You will be prompted to sign in on the Runway mobile site, after which the appropriate build installation page will open. Clicking “Install” from the build details page on your mobile device will install the build
* **Share a link with myself on Slack**: A link to the installation page will be sent to you via Direct Message (DM) on Slack. Open the link on your mobile device, and then click “Install” on the build details page from your mobile device to install the build

{% hint style="warning" %}
iOS builds must be properly signed and provisioned for installation before you can install them on your device. See the [signing & provisioning cheatsheet](/using-runway/build-distro/signing-and-provisioning-cheat-sheet.md) section for more details on how to sign and provision builds for installation.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.runway.team/using-runway/build-distro/installing-builds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.