Distribute Clients
Firezone provides native clients for all major platforms. Use these clients on end-user devices, servers, and any other machine that needs access to your protected Resources.
Installation
See our end-user instructions for basic installation and usage instructions for the Firezone Client that are appropriate for all Firezone users. Or continue reading below for MDM deployment and headless mode instructions suited for Firezone admins wishing to deploy the clients at scale across their organization.
Provision with MDM
Provisioning the Firezone client onto end-user devices should work out of the box using any of the major MDM vendors using the appropriate distribution method below. If you find an exception, please open a GitHub issue so we can prioritize appropriately.
| Platform | Distribution Method |
|---|---|
| Android / ChromeOS | The Android / ChromeOS client is available exclusively from the Google Play Store. |
| Linux | The Linux client is available as a self-contained, statically-linked binary from our releases page. |
| macOS / iOS | The macOS and iOS clients are available exclusively from the Apple App Store. |
| Windows | The Windows client is available as a standalone MSI installer from our releases page. |
Headless mode operation
The Firezone Client can run in headless mode on Linux, Android, and ChromeOS platforms using a Service Account token. This mode is useful for deploying the Client on servers, IoT devices, and other headless devices where a user may not be present to keep the Client authenticated.
See the table below for achieving headless mode operation on each platform:
| Platform | Headless Mode Operation |
|---|---|
| Android / ChromeOS | Set the token key using an MDM provider that supports Android managed configurations. If the token is set and valid, Firezone will automatically connect and authenticate using this token when the Client is started. |
| Linux | Set the FIREZONE_TOKEN and FIREZONE_ID environment variables when running the Client binary. |
| macOS / iOS | Not yet supported. |
| Windows | Not yet supported. |
Need additional help?
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.