Android Client
Firezone supports Android and ChromeOS with a native client available in the Google Play Store.
Prerequisites
- Android: x86, x86-64, ARM, and ARM64 devices running Android 8 or higher are supported.
- ChromeOS: x86, x86-64, ARM, and ARM64 Chromebooks running the Android 11 subsystem or higher are supported.
Installation
- Download the Firezone app from the Google Play Store.
- Run the app. The welcome screen will show "Enable VPN Permission" and the Firezone logo.
- Tap
Request Permission
. Android will show a dialog saying,Connection request
. - Tap
OK
. Firezone will switch to theSigned Out
screen.
Usage
Signing in
- Tap
Sign In
. Firezone will open a sign-in page in your web browser. - Select your account and sign in. Firezone will show your username and Resources.
Accessing a Resource
When Firezone is signed in, web browsers and other programs will automatically use it to securely connect to Resources.
To copy-paste the address of a Resource:
- Tap on the Resource.
- Tap on the address, e.g.
example.com
. Firezone will copy the address to the clipboard. - Open your web browser, such as Google Chrome.
- Paste the link you copied from Firezone.
- Tap the enter or arrow icon on your keyboard to navigate to the link.
Signing out
- Open the Firezone app
- Tap
Sign Out
in the bottom-right corner.
When you're signed out, you can't access private Resources, and the device will use its normal DNS and Internet behavior.
Upgrading
Updates for the Android client are handled through the Google Play Store. Consult the Play Store documentation for more information on how to update apps on your device.
Diagnostic logs
Firezone writes log files to the device's memory. These logs stay on the device
and are not transmitted anywhere. If you find a bug, you can send us a .zip
archive of your logs to help us fix the bug.
To export or clear your logs:
- Open the Firezone app.
- Tap
Settings
in the bottom-left corner. - Tap
Logs
in the bottom-right corner. - Tap
EXPORT LOGS
orCLEAR LOG DIRECTORY
.
Uninstalling
- Go to the device's home screen.
- Swipe up to open the app drawer.
- Long-press the Firezone app icon. A menu will appear.
- Tap
App info
in the menu. This will show the app info screen for Firezone. - Tap
Uninstall
. Android will show a dialog asking,Do you want to uninstall this app?
. - Tap
OK
.
Troubleshooting
We will add troubleshooting steps here in the future.
Known issues
- ChromeOS devices using the Android 9 compatibility layer don't work with Firezone. Android 11 and newer do work. #3620
- Disconnecting the VPN from the System Settings does not work #5413
Need additional help?
See all support options or try asking on one of our community-powered support channels:
- Discussion forums: Ask questions, report bugs, and suggest features.
- Discord server: Join discussions, meet other users, and chat with the Firezone team
- Email us: We read every message.