> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/legacy-products/proxy-builder/setup-and-onboarding/onboard-an-android-device-to-proxy-builder-legacy.md).

# Onboard an Android Device to Proxy Builder (Legacy)

{% hint style="warning" %}
Legacy Documentation Notice: This article applies to Android Agent and Proxy Builder (Legacy), legacy Proxidize products maintained for existing customers. New customers should use Proxidize Mobile Proxies or Residential Proxies.
{% endhint %}

## What is Android Agent (Legacy)?

Android Agent (Legacy) is an Android app used with Proxidize Proxy Builder, a legacy self-hosted platform maintained for existing customers. It allowed Android devices to be connected to the Proxidize Cloud Dashboard and managed as mobile proxy endpoints.

Download the app on the [Google Play Store](https://play.google.com/store/apps/details?id=com.proxidize.proxidizeandroidagent).

## Before You Begin

{% stepper %}
{% step %}

## Disable or uninstall any VPN applications

Running a VPN alongside the Android Agent will cause conflicts. Fully disable or uninstall all VPN apps before proceeding.
{% endstep %}

{% step %}

## Use only one SIM card, inserted in Slot 1

Only one SIM card should be in the device, placed in SIM Slot 1. Using Slot 2 or having multiple SIMs inserted can cause connectivity issues.
{% endstep %}

{% step %}

## Ensure you have a strong mobile signal

Proxy stability is directly tied to signal quality. A weak or unstable signal will result in an unstable proxy. Make sure you're in an area with good mobile coverage.
{% endstep %}

{% step %}

## Grant all required app permissions

The Android Agent requires all permissions to function correctly. Any denied permission will cause issues during onboarding or proxy usage.
{% endstep %}

{% step %}

## Turn off Wi-Fi and use mobile data only

Before starting the onboarding process, disable Wi-Fi and make sure mobile data is active. If Wi-Fi is left on, you'll see a prompt asking you to switch to mobile data. Skipping this may cause the app to get stuck on the "Creating Host" screen.
{% endstep %}

{% step %}

## Make sure your SIM has an active data plan

The app requires a working mobile data connection. If there is no data on your SIM, the app will close immediately.
{% endstep %}
{% endstepper %}

## Onboarding Steps

{% stepper %}
{% step %}

## Log in

1. Open the Proxidize Android Agent app.\
   💡 Tap **"How to Start?"** on the welcome screen, this will guide you through linking your device to your dashboard.
2. Alternatively, Go to [app.proxidize.com](https://app.proxidize.com/), sign in, and find your **PIN** and **QR code** in the top-right corner of the dashboard.
3. In the app, enter the PIN (case-sensitive) or scan the QR code to proceed.

{% hint style="warning" %}
⚠️ **Important:** The PIN and QR code expire after **3 minutes**. Make sure you complete this step and enter your device nickname before they expire. If they expire, you will need to restart the app and repeat the process from the beginning.
{% endhint %}

![](/files/d23fb2c3ce4af1481bce642c2059c0b7d4c492d9)
{% endstep %}

{% step %}

## Register Your Device

Enter a nickname for your device. This is the name that will appear on your cloud dashboard to identify this phone.

![](/files/40ef5f64aedde2e0d174af8f4f70ff4aadaec282)
{% endstep %}

{% step %}

## Grant Permissions

You will be presented with a list of permissions to enable. **Grant all permissions** to ensure full functionality.

![](/files/1b615328d2671478849ceb3b20169949f55327d9)
{% endstep %}

{% step %}

## Creating Your Host

A loading screen will appear while the app sets up your host and endpoint. This takes a few moments, do not close the app during this step.

![](/files/2ab6f665517a61ef76b4eaa6094d9a5c25ce09fd)
{% endstep %}

{% step %}

## Connect

Tap the **Connect** button to begin the connection process. The app will connect your proxies and link to the router.

![](/files/6201bf7f9c3ad587bb3b83a3ae2527b8eb8f586a)

Once the **Connected** screen appears, your device is successfully onboarded.

![](/files/d0d9e038792cda262349445dfc61fc2485050446)
{% endstep %}
{% endstepper %}

## After Onboarding

* Your device will appear under the **Hosts** tab on your cloud dashboard.\
  ![](/files/af3404b9485a25f1600767aaf8b57f80ae92b9fc)
* Your proxies will be available under the **Endpoints** tab (expand your endpoint row) or under the **Proxies** tab.\
  ![](/files/000d1d88f9fcbb8a818f2d45bdd2a81abda9b856)
* Copy your proxy details from there and use them wherever needed.
* Your proxy credentials can be found in the **Host Settings** under the **Endpoints** tab.

## General Notes

* **Do not enable Wi-Fi** while the app is running unless you have the **Wi-Fi Backend** feature enabled. Enabling Wi-Fi without this feature will prevent the app from syncing with the dashboard. If this happens, restart the app and reconnect.
* If the app gets stuck on the **Creating Host** screen, restart the app and repeat the onboarding process from Step 1.

## Need Help?

If you run into any issues during setup or have questions about device compatibility, our support team is available via live chat or by submitting a ticket.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.proxidize.com/legacy-products/proxy-builder/setup-and-onboarding/onboard-an-android-device-to-proxy-builder-legacy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.