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

# Apps

> Manage your app library by uploading custom APKs to deploy to your devices.

The Apps tab is your central hub for managing Android applications. Upload your own APKs to build your app library, then deploy to your devices.

## Overview

The Apps tab allows you to:

* View all apps available in your user space
* Upload custom APK files
* Deploy apps to your devices

## App Library

Your app library displays all applications you have access to. Each app entry shows:

| Field            | Description                                          |
| ---------------- | ---------------------------------------------------- |
| **App Name**     | The application display name                         |
| **Package Name** | Android package identifier (e.g., `com.example.app`) |
| **Version**      | Installed app version                                |

## Uploading Custom APKs

To upload your own APK:

1. Click the **Upload** button
2. Select your APK file from your local machine
3. Wait for the upload and processing to complete
4. The app appears in your library once ready

<Info>
  Uploaded APKs are stored securely in your user space and are only accessible to your account.
</Info>

## Deploying Apps to Devices

Once an app is in your library, you can install it on any of your devices:

| Device Type        | Deployment                                                                                      |
| ------------------ | ----------------------------------------------------------------------------------------------- |
| **Cloud Phone**    | Apps persist across sessions on your dedicated virtual devices                                  |
| **Physical Phone** | Apps install to your dedicated real hardware in the Mobilerun data center                       |
| **Personal Phone** | Apps install to your connected hardware via the [Mobilerun Portal App](/guides/connect-android) |

### Installation Methods

**From the Apps tab**

Select an app and choose which device to install it on.

**From the Playground**

Reference apps by package name in your agent prompts. The agent can install and interact with any app in your library.

**Via API**

Specify apps in your task configuration when running tasks programmatically.

## Managing Apps

### Remove Apps

Delete apps from your library when no longer needed. This removes the app from your user space but does not uninstall it from devices where it was previously deployed.

### Update Apps

Upload a new version of an APK to replace the existing one in your library.

### View App Details

Click on any app to see:

* Full package information
* Installation history
* Devices where the app is currently installed