<aside> ❗

Only selected licenses can be used with Zibra License Server

Unless you received communication from Zibra AI confirming that your license is compatible, you won’t be able to use Zibra License Server

</aside>

Download

You can download the latest license server here

License server supports Windows, Linux, and macOS

Initial Setup

<aside> ⚠️

On Linux and macOS, you need to make file executable before running License Server

Linux - chmod +x ZibraLicenseServer

macOS - chmod +x ZibraLicenseServer.app/Contents/MacOS/ZibraLicenseServer

</aside>

<aside> ⚠️

On macOS, you need to run binary inside of .app package, instead of .app itself

ZibraLicenseServer.app/Contents/MacOS/ZibraLicenseServer <command>

</aside>

<aside> ⚠️

On Windows you need to install the latest version of “Microsoft Visual C++ Redistributable v14 x64” before running ZibraLicenseServer - https://aka.ms/vc14/vc_redist.x64.exe

</aside>

In this guide <... file> refers to either the full file path or a path relative to the current working directory. When a particular file is mentioned for the first time, this means that the command will create said file. Each mention after the first one will expect the existing file generated in one of the previous steps.

  1. Prepare the machine on which you are going to run the local license server (offline machine) and a machine with an internet connection (online machine). After setup, the license will be locked to the machine where you ran ZibraLicenseServer request. You may use a single machine for both, in which case it will need an internet connection during setup.

  2. Run ZibraLicenseServer request <request file> on offline machine. This will create the request file.

  3. Copy the request file to the online machine.

  4. Run ZibraLicenseServer query <license key> <license list file> on an online machine. This will create a license list file. This file contains a list of licenses to checkout.

  5. (optional) Modify hardware_ids_limit in the license list file to specify number of licenses to checkout. If this step is skipped, all available licenses will be checked out.

  6. Run ZibraLicenseServer checkout <request file> <license list file> <license file> on online machine. This will checkout licenses to offline machine and create license file.

    <aside> ℹ️

    Note that you can only use request file once. If you need to checkout licenses again, you must return license first, and then setup the license from the beginning.

    </aside>

  7. Copy license file to offline machine.

  8. Run ZibraLicenseServer run <license file> <config file> on offline machine using license file. This will create config file.

  9. (optional) Modify config file to specify parameters like server port or IP allow list. If this step is skipped, server will run on port 19178 and allow any IP to use licenses.

  10. Run ZibraLicenseServer run <license file> <config file> on offline machine again. This starts license server which will continue running until you terminate it. You can terminate it with Ctrl+C. It is recommended to set it up as a service.

Returning License