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

1. Download the Firezone app from the Google Play Store.
2. Run the app. The welcome screen will show "Enable VPN Permission" and the Firezone logo.
3. Tap Request Permission. Android will show a dialog saying, Connection request.
4. Tap OK. Firezone will switch to the Signed Out screen.

Usage

Signing in

1. Tap Sign In. Firezone will open a sign-in page in your web browser.
2. 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:

1. Tap on the Resource.
2. Tap on the address, e.g. example.com. Firezone will copy the address to the clipboard.
3. Open your web browser, such as Google Chrome.
4. Paste the link you copied from Firezone.
5. Tap the enter or arrow icon on your keyboard to navigate to the link.

Signing out

1. Open the Firezone app
2. 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:

1. Open the Firezone app.
2. Tap Settings in the bottom-left corner.
3. Tap Logs in the bottom-right corner.
4. Tap EXPORT LOGS or CLEAR LOG DIRECTORY.

Uninstalling

1. Go to the device's home screen.
2. Swipe up to open the app drawer.
3. Long-press the Firezone app icon. A menu will appear.
4. Tap App info in the menu. This will show the app info screen for Firezone.
5. Tap Uninstall. Android will show a dialog asking, Do you want to uninstall this app?.
6. 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
• Some apps do not use Firezone's SplitDNS and so cannot access DNS Resources. #4834
• Disconnecting the VPN from the System Settings does not work #5413