bubble-docs/vpn_instructions/android_vpn.md

Connect an Android device to your Bubble VPN

• On another device (not your Android device):

  • Login to your Bubble
  • Navigate to the Devices screen
  • In the “Add Device” section, enter a name for your Android device and click or tap the “Add” button to add it.
  • Click or tap “Show VPN connection info” for your new Android device. A QR code will appear.

• On your Android device:

  • Install the WireGuard from the Google Play Store: https://play.google.com/store/apps/details?id=com.wireguard.android
    • Alternatively, if you have access to the F-Droid App Store, you can install from: https://f-droid.org/en/packages/com.wireguard.android/
  • Open the WireGuard app
  • In the WireGuard app, tap “Add a tunnel”. If you don’t see “Add a tunnel”, tap the Plus icon (+) in the top-right corner of the screen.
  • Tap the “Create from QR code” button
  • You Android device will ask you to allow WireGuard to use your camera. Allow this.
  • A camera view will open. Scan the QR code shown on your other device. You’ll be asked to provide a name for the tunnel. You can choose anything, but it’s probably easiest to use the name of your Bubble.
  • A new connection will now appear in WireGuard. Tap the toggle control to turn it on.
  • You’ll now see a pop-up titled “Connection Request”. Tap “OK” to allow the connection.
  • To ensure your device always remains connected to your Bubble, open the “Settings” app on your Android device
  • Tap “Connections”
  • Tap “More Connection Settings”
  • Tap “VPN”
  • You should see your WireGuard VPN listed. Tap the gear icon to open its settings.
  • Tap the “Always-on VPN” toggle to enable always-on behavior
  • Optionally, also turn on the “Block connections without VPN” setting
  • Congratulations! You are now connected to your Bubble’s VPN!