Jabra for Developers

Appearance

Using JabraCLI ​

This page provides an introduction to the use cases and scenarios JabraCLI is designed for.

JabraCLI is intended for technical users who need predictable and scriptable device control, including:

  • IT administrators managing fleets of USB devices in shared offices and home-office environments
  • Integration engineers embedding device management tasks into enterprise tooling
  • Support and operations teams validating device state during troubleshooting

For a detailed reference of commands and options, see JabraCLI Reference.

USB connected devices only

Be aware that only USB connected Jabra devices (including dongle connected headsets) are currently supported. See Supported Devices.

Manage Devices Offline ​

Consider more user-friendly options

To manage a fleet of Jabra personal or meeting room devices - or update a single device - consider signing up for a Jabra Plus account or use Jabra Direct or Jabra Xpress. These are simpler options for a more user-friendly experience.

Customers looking to implement a fully offline device management solution - e.g. for secure environments without internet access - can use JabraCLI as the basic building block to update firmware and manage centrally defined device settings without any cloud dependencies.

For example, this enables IT administrators to apply a pre-defined configuration on Jabra devices to ensure they are always set up according to company policy when connected.

This is what the jabracli config commands are designed for.

A high-level outline to achieve this could look like this:

  1. Create a config.json file with the desired device settings and firmware versions for the devices you intend to manage.
    • See Configuration File Example for details on the configuration file format and options.
    • Use jabracli device list, jabracli firmware list to get product ID (PID) and firmware version information to include in the configuration file.
    • Use jabracli config show to validate that the configuration file is correctly set up to apply the desired settings and firmware versions on the target devices.
  2. Download the target firmware file(s). From https://www.jabra.com/support or via jabracli firmware download.
  3. Distribute the configuration file(s) and firmware file(s) to a location available through the local file system on the target machines.
  4. Deploy JabraCLI to all target machines where you expect to have Jabra devices connected. This can be done via software distribution tools or manual installation.
  5. Setup automation to run jabracli config apply --config-file <path-to-config.json> on the target machines to apply the configuration and firmware updates on connected devices.

Integrate with Bespoke Enterprise Setups ​

Customers with niche needs for device management setup - e.g. need for uniform device management across different brands of devices, or need to integrate device management into existing enterprise software - can use JabraCLI as a component in a more complex solution that combines the tool with other software and scripts.

The not-continuously-running nature of the JabraCLI commands makes it suitable for integration into larger scripts and software solutions that perform multiple tasks, where device management is just one part of the overall workflow.

Run One-Off Device Tasks ​

Technical users can also use JabraCLI for one-off device management operations, e.g. to update the firmware on a specific Jabra device or to read a specific device property for troubleshooting purposes.

Embed Device Management in Third-Party Software ​

Integration partners building software with Jabra device management capabilities can use JabraCLI as a component in their solution to perform specific device management tasks like updating firmware, applying configurations, or retrieving device information.

For this use case it is recommended to also understand the capabilities of the Jabra SDKs. They integrate more naturally into supported development stacks (JavaScript and .NET). However, for firmware update capabilities JabraCLI is currently the only option.