Proxy Manager shows your Android phones that run the Localtonet app. Check their health, open proxies on them and rotate their IPs from one place.
Before you start #
- An Android phone with the Localtonet app. Install it from Google Play, or use the APK file for phones without Google services. See Android.
- One token for each phone. Every phone signs in with its own token. The Add Device wizard creates it for you.
Some features need more from the phone. The dashboard words the requirements like this:
| Feature | Requirement |
|---|---|
| Change IP, IP rotation | The app needs airplane mode access. Without it the dashboard shows No airplane mode access, so this phone can't change its IP. Allow it in the Localtonet app first. On a phone that is not rooted, the app asks to be set as the default assistant app to switch airplane mode. |
| Restart phone, restart rules, restart links | Works only on rooted phones or when Localtonet is the device owner. |
| TCP/IP fingerprint | Needs a rooted phone and app v8.2 or newer. |
| SMS and USSD | The Localtonet SMS app on the same phone, signed in with the same token. See SMS bot. |
| Shadowsocks proxies | App v9.5 or newer. |
| VLESS proxies | App v9.9 or newer. |
Proxy Manager is in the menu of your personal dashboard. It is not shown while a team is selected.
Add a phone #
-
Name the device #
Open Proxy Manager and select Add Device. Enter a Device name you will recognize in your device list, for example
RackA-Phone01, and select Create device. The name can have up to 30 characters, and spaces become dashes. This creates the token of the phone, so the name must not be used by another token. -
Install the app #
Choose Google Play (recommended) or APK file (for phones without Google services). Point the phone's camera at the QR code, open the link it shows and install Localtonet. Open the app once it is installed, then select Continue. Skip this step if the app is already installed.
-
Sign in on the phone #
In the Localtonet app, scan the QR code or type the One-time PIN. You can also paste the Auth token. The PIN expires after one minute and works once; select New PIN to get another one.
The wizard waits for the phone and then confirms that it signed in and is online. If you close it earlier, the token stays under My Tokens.
A phone that you signed in with a token from My Tokens needs no wizard: it shows up in Proxy Manager as soon as the app connects.
To sign a phone in again later, select the QR button (QR, PIN and token) on its card. It opens Connect device with the QR code, a PIN and the token of that device. Keep your token and PIN private.
The fleet page #
The top of the page summarizes the fleet: Devices online, Active proxies, Need attention and App updates. Selecting one of the last two filters the list.
| Control | What it does |
|---|---|
| Filters | All, Online, Offline, Needs attention, Update available. |
| Search | Search by name, model, token or IP. Press / to jump to the search field. |
| Sort | Sort: Status, Sort: Name, Sort: Active proxies, Sort: Battery, Sort: Temperature. |
| Layout | Cards or List. In the list you can also sort by clicking a column heading. |
| Refresh | Reloads the devices. The arrow next to it sets Auto refresh: Off, Every 30 seconds, Every minute or Every 5 minutes. |
| Set as start page | Opens Proxy Manager first, instead of the Dashboard, when you open the dashboard or the installed web app in this browser. Select it again to make the Dashboard your start page again. |
What a device shows #
| Item | Meaning |
|---|---|
| Status | Online or Offline: whether the Localtonet app on the phone is connected. |
| Public IP | The public IP the phone last reported. For an offline phone it is the last public IP before the phone went offline. Click it to copy. |
| Proxies | Active and total proxies on the phone. Click to copy their connection lines. A phone without proxies shows Add. |
| Battery, temperature | The last reported battery level and battery temperature. |
| App | The app version. Need Update means: install the latest Localtonet app on this phone. |
| Auto | Whether automatic IP rotation is on, and its interval. Click to change it. |
A device needs attention when it is offline with active proxies, when its battery is low (20% or less and not charging), or when it is running hot (battery temperature of 45°C or more).
Actions on one device #
- Rotate changes the IP now: it toggles airplane mode on the phone for a new mobile IP. The proxies reconnect in a few seconds.
- The more menu offers Open device, Proxies, IP rotation, Restart rules, Activity, Copy proxies, Copy token, Restart phone and Delete device.
Between two IP changes, or two restarts, of the same phone you have to wait 10 seconds. The dashboard tells you how many seconds are left.
Bulk actions #
Tick devices to select them. Shift-click selects a range, and the checkbox above the list selects all shown devices. A bar with the actions for the selection appears at the bottom:
| Action | What it does |
|---|---|
| Rotate | Changes the IP of the selected devices now. Offline phones, phones without airplane mode access and phones that just changed IP are skipped. |
| Restart | Restarts the selected phones after you confirm. Offline phones and phones that were just restarted are skipped. |
| Copy proxies | Copies the proxies of the selected devices, one connection per line, in your URL pattern if you set one. |
| Copy tokens | Copies the tokens of the selected devices, one per line. |
The device page #
Open device opens the page of one phone. Its header shows the status, active proxies, battery, temperature, app version and whether the SMS app is connected. You can rename the device there, and use Rotate, Restart phone and Delete device. The page has these tabs: Proxies, IP rotation, Restart, Fingerprint, SMS, Activity, IP history and Sign-in.
Proxies #
The form at the top creates proxies on this phone:
| Field | What to enter |
|---|---|
| Proxy type | HTTP, SOCKS5 (UDP), Shadowsocks (UDP), VLESS + WS (UDP) or VLESS + Reality (UDP). A type that needs a newer app says so. |
| Server region | The Localtonet server the proxy is reached through. |
| Subdomain | Random, or Custom to enter a Custom subdomain yourself. |
| Qty | How many proxies to create, up to 10. A custom subdomain creates one. |
Select Create. If the phone is online, the proxy starts right away; otherwise it starts when the phone is online again. Below the form is the proxy list of this device. It is the same list, with the same settings, as on the Proxy Server page. The URL Pattern button at the top customizes the proxy URLs that are displayed and copied.
IP rotation #
The phone turns airplane mode on and off so that the carrier assigns a new IP. The phone runs these settings itself, so they keep working while the page is closed.
| Setting | What it does | Values |
|---|---|---|
| Rotate IP automatically | Turns airplane mode on and off on a schedule. | On or off. |
| Rotate every | The time between two IP changes. | At least 10 seconds. Enter it in seconds, minutes or hours. |
| Airplane mode duration | How long the phone stays offline on each IP change, including manual and link changes. | 3 to 100 seconds. With a shorter time the carrier may not give a new IP. |
| Require a new IP | Tries again when the carrier gives back an IP the phone had recently. | Retry up to: 1 to 10 extra airplane mode cycles. Repeated means within: 1 to 3000 minutes. |
| Recover idle mobile data | Toggles airplane mode when mobile data stays idle, which often fixes a stuck connection. | Idle for: 1 to 60 minutes. |
Select Save changes. The phone picks up the new settings in a few seconds; an offline phone gets them when it reconnects.
For a quick change you do not need the device page: IP rotation in the more menu of the fleet page, or the Auto label of a device, opens Automatic IP rotation with the interval (Time) and the airplane mode duration (Delay).
Change IP links and restart links #
The IP rotation tab has Change IP links and the Restart tab has Restart links. Opening a change IP link changes this phone's IP; opening a restart link reboots it. Select New link to create one, and give each customer or script its own link. Delete a link to revoke it. A phone can have up to 10 links of each kind.
A link answers with a short JSON result: Success when the command was sent, or a reason such as Device not connected. A change IP link accepts one request every 10 seconds; an earlier request is answered with the number of seconds to wait.
The links use localtonet.com as their host, for example https://localtonet.com/android/changeip?u=<LINK_ID>. To use a name in your own domain as the host, add a record of type Android in DNS Manager. See Android records.
A link works for anyone who has it. No sign-in is asked. Share a link only with the people and tools that should control this phone.
Restart #
Restart automatically reboots the phone when any of the checked rules is met. The phone checks the rules itself.
| Rule | Restarts the phone when | Values |
|---|---|---|
| Battery drops below | The battery level falls under this value. | 1 to 99 % |
| On a schedule, every | A fixed interval has passed. | 1 to 24 hours |
| Offline for | The phone stays disconnected from Localtonet this long. | 1 to 3000 minutes |
Check at least one rule, or turn automatic restart off. Restart phone reboots the phone at once: its proxies stop until the Localtonet app reconnects.
Fingerprint #
Websites can tell the operating system from how a device speaks TCP/IP. On the Fingerprint tab you choose what this phone's proxy traffic should look like:
| Option | Looks like |
|---|---|
| Android | The phone's own |
| Windows 10 | Desktop PC |
| macOS | Mac computer |
| iOS | iPhone or iPad |
| Nintendo | Game console |
| FreeBSD | Server |
| Linux | Desktop or server |
| ChromeOS | Chromebook |
| Linux (barebone) | Minimal Linux |
| FreeBSD 9 | Older FreeBSD |
SMS and USSD #
With the Localtonet SMS app installed on the phone and signed in with the same token, the SMS tab can send a text message from the phone's SIM card (Send SMS: phone number and message) and dial a USSD code such as *100# (Run USSD code), for example to check the balance. To read incoming SMS, use the Telegram bot described on the SMS bot page.
Activity, IP history and Sign-in #
- Activity lists IP changes and restarts on this phone, whether they came from a schedule, a link or the dashboard. Filter by event type and trigger.
- IP history lists every public IP this phone reported, newest first, with counters for the last hour and for repeated IPs. Repeated IPs are ones the phone already had before.
- Sign-in repeats the three steps to connect a phone to this device: install the app, sign in with the QR code, PIN or token, and check the connection.
Delete a device #
Deleting a device deletes its token. Every tunnel that uses the token is stopped and deleted, including its proxies. The phone can no longer connect with this token. This can't be undone.
Troubleshooting #
The phone does not appear in Proxy Manager
Install Localtonet on the phone and sign in with a token. The phone shows up as soon as the app connects. If the wizard keeps waiting, check that the phone has an internet connection and that you used the code or token of this device.
No airplane mode access
The app on this phone can't switch airplane mode, so IP changes are not available. Allow it in the Localtonet app first.
The device is offline. Open the Localtonet app on the phone and try again
Commands reach a phone only while its app is connected. Rotation settings you save for an offline phone reach it when it reconnects.
Wait … seconds before sending this command again
The same phone accepts one IP change, and one restart, every 10 seconds.
The IP did not change after a rotation
Carriers can hand back the same IP. Raise Airplane mode duration, and turn on Require a new IP so the phone tries again when it gets a recent IP.
Restart does nothing
Restarts work only on rooted phones or when Localtonet is the device owner. The Restart tab warns when the phone is not reported as rooted.
The fingerprint is not applied
TCP/IP fingerprints need a rooted phone and app v8.2 or newer. Update the Localtonet app on the phone.
You need to purchase balance to use this feature
Sending SMS and running USSD codes from the dashboard needs Balance on your account. See Plans and Balance.
