Proxies
Assign and connect a proxy to a device
The complete two-step process to route a cloud phone through your proxy: (1) assign the proxy to the rental session from My Devices, (2) connect the proxy from inside the viewer.
4 min read
Getting a cloud phone to use your proxy requires two separate steps:
- Assign the proxy to the rental session — saves the proxy into the session config. Done on the My Devices page.
- Connect the proxy in the viewer — activates the actual network tunnel. Done from the Actions menu inside the viewer.
Skipping step 2 means the device is still not routing through the proxy, even though it was assigned in step 1.
Step 1 — Assign a proxy to a rental session
Proxy assignment is always done from the device side (My Devices), not from the Proxy Management table.
Open My Devices (app.xcloudphone.com/dashboard/devices).
Find the device card you want to configure.
Click the pencil icon on the card to open the Edit Session dialog.
In the Proxy field, type or search for the proxy you want to bind — the autocomplete pulls from your proxy library.
Pick a proxy from the suggestions → click Confirm.
After saving, the device card shows a proxy badge (type + short address) so you can see at a glance which proxy is bound to which device.
To remove a proxy from one device, reopen the Edit Session dialog → clear the Proxy field → save.
On My Devices, tick the checkboxes on the device cards you want to update (or use Select all).
In the action bar that appears at the top, click Update Proxy.
A dialog opens listing every selected device — each device has its own proxy dropdown.
Pick a proxy for each device (the same proxy for all, or a different one per device).
Click Update Proxies. The system only saves devices whose proxy actually changed from its initial value (the count of changed devices is shown inside the dialog).
Use bulk assignment after importing a new batch of proxies and distributing them across many devices at once.
Tick the devices you want to clear.
Click Unbind Proxy in the action bar.
Confirm. The selected devices return to having no proxy assigned.
Only devices that currently have a proxy are affected. Devices without a proxy are skipped, and the dialog will note "X out of Y devices had no proxy to unbind."
Step 2 — Connect the proxy in the viewer
After assigning, you need to activate the proxy from inside the viewer. This is the step that actually turns on the network tunnel.
Open the viewer for a device that has a proxy assigned (click the eye icon on the card).
In the control panel (or the Actions tab on mobile), open the Actions menu.
Click Connect proxy.
The viewer sends the connect command — wait a few seconds. When it succeeds, the proxy indicator in the viewer switches to connected.
If the device has no proxy assigned in Step 1, Connect proxy will not work or will return an error. You must assign a proxy from My Devices first.
Disconnect proxy from the viewer
Click Disconnect proxy in the Actions menu. The device immediately falls back to the server's default IP. The proxy remains assigned to the session — it's just inactive until you connect it again.
Verify the proxy is working
After connecting, go inside the cloud phone → open a browser → visit an IP check site (for example ifconfig.me or whatismyip.com). If the displayed IP matches your proxy's public IP, the setup is working correctly.
Managing proxies from the Proxy Management page
The Proxy Management page (app.xcloudphone.com/dashboard/renter-proxies) is not used to assign proxies to devices — that step always happens on My Devices. But you have two useful management actions here:
- See how many sessions use a proxy — the Binding Count column in the table.
- Unbind all sessions from one proxy — click the Unbind (WifiOff) icon on the row, or tick multiple proxies and click Unbind in the action bar. This clears the proxy from every session currently using it — handy when a proxy goes bad or you are switching providers.
Important notes
Assign and connect the proxy before logging in to any account inside the cloud phone. Switching IPs mid-session can trigger security checks on most platforms.
When a proxy dies or expires, the device loses internet access entirely. Check your proxies often — see Test whether a proxy is alive or dead.