> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/cloud-phones/edit-restart-and-reset-cloud-phones.md).

# Edit, restart or reset a cloud phone

Rename a cloud phone, change its proxy, power it on or off, restart it or reset it to a clean device from the ⋮ menu in Cloud Phones.

Go to **Cloud Phones** and click the three-dot icon (⋮) next to the phone. Click **Edit** to change its name or proxy, **Restart** to reboot it, or **Reset device** to wipe it and give it a new device identity.

The ⋮ menu only shows the actions that work in the phone's current state. For example, **Restart** only appears while the phone is running, and while a phone is resetting or switching its Android version the menu offers nothing but **Move to group**.

<div data-with-frame="true"><figure><img src="https://1094567560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2Fgit-blob-dd076d2cd72034f8396cf8c11fdc4daf3a4f6c53%2Fv5-cloud-phone-menu-stopped.png?alt=media" alt="The ⋮ menu of a stopped cloud phone"><figcaption></figcaption></figure></div>

### Edit a cloud phone's name and proxy

{% stepper %}
{% step %}

#### Open the edit panel

Click **Cloud Phones** in the left-side menu, click the ⋮ icon next to the phone and click **Edit**. The panel opens with the phone's name as its title.
{% endstep %}

{% step %}

#### Change the name or proxy

Change the **Name**, or pick a new proxy:

* **Keep current proxy**: leave the proxy as it is. This is selected when you open the panel (for a phone on a free proxy, **Free proxy** and its country are selected instead).
* **Proxy Library**: use a proxy saved in your Proxy Library.
* **Custom proxy**: enter a proxy from another provider.
* **Buy proxy**: buy a proxy in Incogniton's proxy shop.
* **Free proxy**: use one of Incogniton's free proxies in a country you choose.

Cloud phones do not support SOCKS4 proxies. Use an HTTP, HTTPS or SOCKS5 proxy.
{% endstep %}

{% step %}

#### Save

Click **Save**. A message confirms "Cloud phone saved."
{% endstep %}
{% endstepper %}

{% hint style="info" %}
To check the IP address and location the phone shows after a proxy change, open [bscan.info](https://bscan.info), Incogniton's own IP and browser scan site, in a browser on the cloud phone.
{% endhint %}

The same panel also lets you change **Resolution**, **Location**, **SIM**, **Time zone & region**, **Language** and **Description**. The Android version is not part of the edit panel: use **Change Android version** in the ⋮ menu instead (this erases all data on the phone).

Two shortcuts: double-click the phone's name in the list to rename it in place, or double-click its proxy cell to open the edit panel at the proxy.

**Edit** is not offered while the phone is still being set up. A phone that shows **Needs a proxy** has **Set up phone** instead of **Edit**: it asks for a name and a proxy, and the phone can't start until you save one.

<div data-with-frame="true"><figure><img src="https://1094567560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2Fgit-blob-9fb34697f3fbeb5770937a80a69568900f81788e%2Fv5-cloud-phone-edit-panel.png?alt=media" alt="The edit panel of a cloud phone with the name and proxy options"><figcaption></figcaption></figure></div>

### Power a cloud phone on or off

* **Power on**: click **Power on** on the phone's row, or in the ⋮ menu. The phone starts and its screen opens in a window. The first start of a new phone takes longer.
* **Power off**: click **Power off** on the row, or in the ⋮ menu. This closes the phone's window and its local ADB connection.

Minutes of startup time count while a phone is powered on and are shared by all your phones, so power phones off when you are done. Closing the phone's window also powers it off when **Stop the cloud phone when its window closes** is on in **Settings > Preferences**.

#### Stop a phone that is still starting

While a phone boots, its row shows **Power off** instead of **Power on**, so you can stop it without waiting for it to finish starting. Click **Power off** on the row or in the ⋮ menu. Incogniton keeps sending the stop until the phone is off.

### Restart a cloud phone

Click the ⋮ icon next to a running phone and click **Restart**. Incogniton closes the phone's window and reboots the phone. A message shows "… is restarting." and the row shows the phone as starting until it is back up. Open it again with **Connect**.

### Reset a cloud phone

A reset reinstalls the phone's system and gives it a new device identity. Use it when you want to start over with a clean phone.

{% stepper %}
{% step %}

#### Choose Reset device

Click the ⋮ icon next to the phone and click **Reset device**.
{% endstep %}

{% step %}

#### Confirm

The **Reset device?** dialog explains what is removed and shows how many resets are left this billing period. Click **Reset** to start.
{% endstep %}
{% endstepper %}

What a reset does:

* **Removes** all installed apps and their data, and gives the phone a new device identity.
* **Keeps** the phone in your account. A cloud phone can be reset but not deleted.
* **Closes** the phone's window and its ADB connection. While the reset runs, the row shows **Resetting** and the phone can't be used.
* **A phone that is off** is started for the reset and switched off again afterwards. This takes a few minutes.

Limits:

* Each phone has a limited number of resets per billing period. The dialog shows how many are left; with none left, **Reset** is disabled until the next period starts.
* **Reset device** is only offered when the phone is fully on or off: not while it is starting, stopping or still being set up.

{% hint style="warning" %}
A reset can't be undone. Everything on the phone is removed.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1094567560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2Fgit-blob-ef685f0b1cc8323bcca7df72f22401cea500551c%2Fv5-cloud-phone-reset-dialog.png?alt=media" alt="The Reset device? confirmation with the number of resets left"><figcaption></figcaption></figure></div>

### Who can do what

In a team, the cloud-phone permissions decide which actions a member sees:

* **Power on**, **Power off**, **Restart** and **Connect** need **Use cloud phones (power, restart, connect)**.
* **Edit**, **Reset device**, **Change Android version**, ADB and root need **Manage cloud phones (edit, proxy, reset, Android version, ADB, root, apps, automation, move)**.

See [Manage cloud phones](https://docs.incogniton.com/cloud-phones/manage-cloud-phones.md#team-permissions) for how to set these permissions on a role.

{% hint style="info" %}
If you have any questions about editing or resetting cloud phones, don't hesitate to contact our [support department](https://incogniton.com/contact/).
{% endhint %}
