Android

InstallCopy Anchor Link

• Pangolin on Google Play - This is the official page to download the latest Pangolin app for Android devices.
• All Versions - The releases section of this repository contains release notes and download artifacts for the latest version and all older versions.

Installation StepsCopy Anchor Link

1. Download and install the Pangolin app

   Download and install the Pangolin app from the Google Play Store using the link above.

2. Launch Pangolin

   Open the Pangolin app from your app drawer or home screen.

3. Log in with your Pangolin account

   Log in on your Pangolin Cloud account or your self-hosted Pangolin instance.

4. Connect to Pangolin

   Tap the Connect button to establish a VPN connection. On the first connection, you may be prompted to allow the VPN connection.

ConfigureCopy Anchor Link

Always-on VPNCopy Anchor Link

Always-on VPN keeps Pangolin connected and brings the tunnel back up if it drops. Connect once in the Pangolin app first so Android lists Pangolin under VPN, then turn it on in system settings:

1. Open the Settings app.
2. Go to Network & internet, then VPN. On some devices this is under Connections > More connection settings > VPN.
3. Tap the settings icon next to Pangolin.
4. Turn on Always-on VPN.

Private DNSCopy Anchor Link

Set Android's Private DNS to Automatic or Off when using Pangolin. If it is set to a provider hostname (for example one.one.one.one or a NextDNS address), Android sends every DNS lookup to that provider and skips Pangolin's DNS. Aliases and private resources then resolve to the wrong address or not at all, even though the app shows Connected.

1. Open the Settings app.
2. Go to Network & internet, then Private DNS. On some devices this is under Connections > More connection settings > Private DNS.
3. Select Automatic or Off.
4. Disconnect and reconnect Pangolin.

Show Persistent VPN NotificationCopy Anchor Link

When enabled, Pangolin keeps a status notification while connected. A temporary notification may still appear when connecting or recovering. Android's own VPN indicators are unaffected.

Leaving this on makes it less likely that Android will stop the connection while the app is in the background.

Enable Log CollectionCopy Anchor Link

When enabled, tunnel logs are saved to a file that can be downloaded for troubleshooting. See Client Logs.

Battery OptimizationCopy Anchor Link

To ensure Pangolin functions correctly in the background on Android devices, it's recommended to disable battery optimization for the app. This prevents the operating system from restricting its background activities, which could lead to disconnections.

1. Open the Settings app on your Android device.
2. Navigate to Apps & notifications (or simply Apps on some devices).
3. Find and select the Pangolin app from the list of installed apps.
4. Tap on App battery usage.
5. Select Allow background usage and enable if disabled.
6. From the options menu, choose Unrestricted.

UpdateCopy Anchor Link

Updates are delivered through the Google Play Store. Release notes and older builds are in the GitHub releases.

UninstallCopy Anchor Link

1. If Always-on VPN is enabled for Pangolin, turn it off first: Settings > Network & internet > VPN > Pangolin settings, then disable Always-on VPN.
2. Uninstall Pangolin from Settings > Apps > Pangolin > Uninstall, or touch and hold the app icon and choose uninstall.

Deleting the app removes the VPN profile. Reinstall from Google Play or a GitHub release if you want to use Pangolin again.