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

# Cloud Phone Setup

> Best practices for setting up and using your Cloud Phone for reliable, stealth automation.

Your Cloud Phone is a high-performance virtual Android device with dedicated resources, persistent state, and advanced automation capabilities. It provides a persistent environment and profile support so you can manage multiple device identities from a single subscription.

The Cloud Phone is a [dedicated virtual device](/device-types#cloud-phone) in Mobilerun. This guide walks you through the best practices for getting the most out of it.

## 1. Create a Google Account Beforehand

Before your Cloud Phone is ready, prepare a Google account that you will use on the device. Having this ready in advance lets you set up the phone quickly once provisioning completes.

* Create a Google account at [accounts.google.com](https://accounts.google.com)
* Keep the credentials accessible. You will need them to sign into Google Play and other Google services on the device

<Tip>
  Having credentials pre configured in Mobilerun means the agent can handle Google sign-in automatically when needed.
</Tip>

## 2. Configure a Proxy

A proxy is **mandatory** for every Cloud Phone. The device cannot be provisioned without one attached. You need to **bring your own** SOCKS5 proxy. Mobilerun does not provide managed proxies for Cloud Phones.

1. Open the [Proxies](/proxies) tab in the dashboard
2. Register your SOCKS5 proxy (host, port, and credentials)
3. Select that proxy when creating the device

See the [Proxies](/proxies) page for details on the supported proxy types and how Smart IP automatically aligns the device's location, timezone, and language with the proxy country.

<Warning>
  Always ensure your proxy country matches the persona and locale you want the device to present. A mismatch is a common detection signal.
</Warning>

## 3. Wait for Provisioning

After purchasing your Cloud Phone and attaching a proxy, the device needs to be initialized before you can use it. This process spins up the virtual device, installs the base system, and prepares it for your account.

* **Do not assume the phone is broken if it doesn't appear instantly.** Provisioning takes some time.
* You can monitor the status of your device in the [Devices](/devices) tab. Once the device shows as **Ready**, you can start using it.
* If provisioning seems stuck or takes unusually long, reach out on [Discord](https://discord.gg/droidrun) or email us at [contact@mobilerun.ai](mailto:contact@mobilerun.ai) and we'll investigate.

<Warning>
  Provisioning typically completes within a few minutes, but can occasionally take longer. Please wait for the device to show as **Ready** before reporting an issue.
</Warning>

## 4. Install Apps via Google Play Store

Always install apps through the **Google Play Store** on the device. Do **not** download APKs from third party sources like APKMirror.

**Why this matters:**

* Third party APKs can be incompatible with the device and cause it to crash or become unresponsive
* Play Store apps are verified, correctly signed, and receive automatic updates
* Using Play Store is the normal behavior of a real user, which supports stealth

**How to install apps:**

1. Open Google Play Store on the device
2. Sign in with your Google account
3. Search for and install the app you need

You can also use the [Apps](/apps) tab in Mobilerun to manage your app library and deploy apps to your device.

## Quick Setup Checklist

Use this checklist to get your Cloud Phone production ready:

* Prepare a Google account before the device is ready
* Register your own SOCKS5 proxy in the [Proxies](/proxies) tab and attach it to the device
* Wait for provisioning to complete
* Sign into Google Play Store on the device
* Install apps only through Google Play Store

## Need Help?

If you run into any issues or need further assistance, reach out to us:

* **Discord:** [discord.gg/droidrun](https://discord.gg/droidrun)
* **Email:** [contact@mobilerun.ai](mailto:contact@mobilerun.ai)