Wannan shafin bai samu a cikin Hausa tukuna ba. Ana nuna shi da Turanci.
Install Localtonet on Android
A wannan shafin 9 sassa
The Localtonet app turns an Android phone or tablet into a device of your account. Install it from Google Play or as an APK file, sign in with a QR code, a PIN or your token, then create and start tunnels for the phone in the dashboard.
Before you start #
- A Localtonet account. Create one for free if you do not have one.
- An Android phone or tablet. The app's minimum Android version is 5.0 (API level 21).
- A token for the phone. Create one under My Tokens with Create token and give it a name you recognize. Use a separate token for each phone.
Install the app #
| Source | Download | Notes |
|---|---|---|
| Google Play | Localtonet on Google Play | Google Play installs the app and keeps it up to date. |
| APK File | localtonet-mobile.apk | For devices without Google Play. Android asks you to allow the installation of apps from the browser or file manager you open the file with. |
| APK File (.zip) | localtonet-mobile.zip | The same APK inside a ZIP archive. Extract it, then open the APK. |
The same three choices are on the Downloads page under Android.
Sign in #
The app opens on the Sign in to Localtonet screen with one field, Authtoken or PIN, a scan button next to it and the Connect button. You can sign in three ways. The QR code and the PIN come from the dashboard.
-
Open the connect dialog in the dashboard #
On another device, open My Tokens and select the QR code button next to the token of this phone. Its tooltip reads Connect the Android app with a QR code or PIN. The Connect device dialog opens with a QR code, a PIN and the token.
-
Sign in with the QR code, the PIN or the token #
Method In the dashboard In the app Scan QR code Keep the QR code on the screen. Tap the scan button next to the field and point the camera at the code. The app asks for camera access the first time. The token appears in the field. Enter a PIN instead Read the 6-digit PIN. The dialog counts down how long the PIN is still valid. Select Generate new PIN when it has expired. Type the PIN into the field. Copy token Copy the token and send it to the phone, or open the dashboard on the phone itself. Paste the token into the field. If a token or a PIN is on the clipboard, the app fills it in when the screen opens or when you tap the field. A PIN is valid for one minute and works once.
-
Select Connect #
Tap Connect. The app shows
Checking..., signs in and switches to its main screen. Under My Tokens the token now shows Online.
Keep your token and PIN private. They allow the Localtonet app to connect as this device.
The setup wizard on the Dashboard offers the same sign-in: on its last step, the Android tab shows the token and, when the wizard is open on a computer, a QR code with the hint Scan to get the AuthToken on your phone.
What the app shows #
After sign-in the app shows the name of the token, the connection status and the IP address of the phone, an overview with the number of tunnels, ping, upload and download, and the list of tunnels that run on this phone. While the list says No active tunnels, create and start a tunnel for this token in the dashboard, see Quick start.
| Control | What it does |
|---|---|
| Sign Out | Asks for confirmation, disconnects, removes the token from the app and returns to the sign-in screen. |
| Quit Localtonet | Asks for confirmation, stops the tunnels and closes the app. After this the app does not start by itself until you open it again. |
While the app is connected, Android shows a permanent Localtonet notification with the text Tunnels are working. It belongs to the background service that keeps the tunnels alive when the app is not on the screen. After the phone restarts, the app opens again by itself, unless you closed it with Quit Localtonet.
Permissions the app asks for #
| Request | When | Why |
|---|---|---|
| Stop optimizing battery usage | When the app starts, as long as battery optimization is on for it. | Battery optimization lets Android stop the app in the background, which disconnects the tunnels. |
| Permission Required: display over other apps | When the app comes to the screen, as long as the permission is missing. Continue opens the Android setting. | If you select Cancel, the app warns: Your tunnels may not work properly (Settings-Apps-Localtonet-Advanced- Draw over other apps). |
| Notifications | On Android 13 and later, when the app comes to the screen. | For the permanent notification of the background service. |
| Camera | The first time you tap the scan button. | To scan the QR code of a token. Without it the app shows Camera permission required; use a PIN or paste the token instead. |
| VPN connection | When the phone joins a VPN network of your account. | Android asks for this before any app may set up a VPN. See VPN Manager. |
What an Android device adds in the dashboard #
An Android phone serves the same tunnels as any other device. In addition, My Tokens shows a Device column for Android devices: they provide device settings, SMS when supported, and action logs. Thread usage, battery and temperature show the last values reported by the device.
| Feature | What it is | Read more |
|---|---|---|
| Mobile proxies | Each phone becomes a separate proxy with its own mobile IP when every phone has its own AuthToken. | Proxy Server |
| Fleet of phones | Proxy Manager lists your Android phones that run the Localtonet app. You check their health, open proxies on them and rotate their IPs from one place. | Proxy Manager |
| Device settings | Android device settings in the Device column, with sections such as Airplane Mode, Change IP and Restart Device. Some of them are marked as only for rooted or device-owner phones. | Proxy Manager |
| SMS | SMS settings in the Device column, shown when the device supports SMS. | SMS bot |
| Action logs | Device action logs in the Device column. | AuthTokens |
For a File Server tunnel on a phone, the app directory is always used as the shared folder, see File Server.
Update #
Google Play updates the app. If you installed the APK, download the current APK from the Downloads page and install it over the existing app.
Under My Tokens, the Client column shows the app version the device last reported and a Need Update badge when a newer one is available.
Troubleshooting #
Pin or authtoken is not valid.
The app could not turn your input into a token. A PIN is valid for one minute and only once: select Generate new PIN in the dashboard and enter the new one. A token must have all 33 characters; copy it again with Copy token.
PIN expired. Generate a new PIN to continue.
The dialog in the dashboard shows this when the minute is over. Select Generate new PIN.
Please enter an authtoken or PIN.
The field was empty when you tapped Connect.
Camera permission required
The app has no camera access, so it cannot scan the QR code. Allow the camera for Localtonet in the Android settings, or sign in with a PIN or the token.
The token shows Offline in the dashboard
The device is disconnected. Open the Localtonet app on the device to connect. If this happens whenever the phone is idle, check that battery optimization is off for Localtonet and that the app may display over other apps.
The app does not come back after a restart of the phone
The app does not start by itself after you closed it with Quit Localtonet. Open it once by hand.