মূল কনটেন্টে যান
Localtonet Localtonet ড্যাশবোর্ড

এই পেজ এখনো বাংলা ভাষায় নেই। ইংরেজিতে দেখানো হচ্ছে।

Install Localtonet on Android

এই পাতার সহায়তা
এই পেজে 9 সেকশন
  1. Before you start
  2. Install the app
  3. Sign in
  4. Open the connect dialog in the dashboard
  5. Sign in with the QR code, the PIN or the token
  6. Select Connect
  7. What the app shows
  8. Permissions the app asks for
  9. What an Android device adds in the dashboard
  10. Update
  11. Troubleshooting
  12. Related pages

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 #

SourceDownloadNotes
Google PlayLocaltonet on Google PlayGoogle Play installs the app and keeps it up to date.
APK Filelocaltonet-mobile.apkFor 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.zipThe 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.

  1. 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.

  2. Sign in with the QR code, the PIN or the token #

    MethodIn the dashboardIn the app
    Scan QR codeKeep 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 insteadRead 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 tokenCopy 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.

  3. 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.

ControlWhat it does
Sign OutAsks for confirmation, disconnects, removes the token from the app and returns to the sign-in screen.
Quit LocaltonetAsks 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 #

RequestWhenWhy
Stop optimizing battery usageWhen 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 appsWhen 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).
NotificationsOn Android 13 and later, when the app comes to the screen.For the permanent notification of the background service.
CameraThe 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 connectionWhen 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.

FeatureWhat it isRead more
Mobile proxiesEach phone becomes a separate proxy with its own mobile IP when every phone has its own AuthToken.Proxy Server
Fleet of phonesProxy 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 settingsAndroid 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
SMSSMS settings in the Device column, shown when the device supports SMS.SMS bot
Action logsDevice 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.

সাপোর্ট