License manager¶

Custom license key¶

To use a custom license key, map it via a volume and set the path to it with the HASP_LICENSE_FILE environment variable:

docker run \
    --env HASP_LICENSE_FILE=/license.v2c \
    --volume /etc/idliveface/license.v2c:/license.v2c \
    ...

Note that the provided path should point to a file located inside the container.

Embed license into the image

If you need an image with the custom license key, you can embed it with this Dockerfile:

FROM 367672406076.dkr.ecr.eu-central-1.amazonaws.com/facesdk/idface-server-prod:1.47.0

COPY license.v2c /etc/license.v2c
ENV HASP_LICENSE_FILE /etc/license.v2c

Download

RTE¶

By default the Server uses an admin mode license and starts an additional system service (RTE, or Run-time Environment) inside the container. It is possible to switch to a user mode license that does not need any extra processes. For that set the HASP_ENABLE_RTE environment variable to false:

docker run --env HASP_ENABLE_RTE=false ...

We don't advise to use this option as user mode licenses have stability issues in some cloud environments.

Note

Before version 1.31 the HASP_ENABLE_RTE was set to false by default.

You can read more about the user and admin mode licenses in the SDK's license article.

If you often see "License Manager is not running" error you can increase the RTE startup timeout (in seconds):

docker run --env HASP_RTE_STARTUP_TIMEOUT=10 ...

Network licenses¶

If you use a network license server you can set its location via the HASP_NETWORK_LICENSE_SERVER environment variable:

docker run --env HASP_NETWORK_LICENSE_SERVER=license.example.net ...

This will implicitly enable the RTE service.