Skip to content

Frequently Asked Questions

Info

You can find solutions to common issues on the Troubleshooting page.

Where can I download the latest Web API version?

Use the Regula Download Manager tool.

Note that the Regula Downloads Manager is only required for the download of the package and has no further impact on the Web API operation.

How to change the service listening address/port?

The config file is saved under the following path:

  • C:\Program Files\Regula\Face Processing Service\\.env for the х64 version.

  • C:\Program Files (x86)\Regula\Face Processing Service\\.env for the x86 version.

To change the service listening address/port, you need to change the value: FACEAPI_BIND="0.0.0.0:41101"

By default, the service listening address/port is:

  • 0.0.0.0:41101 for HTTP

  • 8443 for HTTPS

How to run the Web API service using HTTPS?

Follow the Security guide.

Where can I find logs?

For detailed information about the logging types and location, see Configuration.

How to check container health?

Use the /api/healthz endpoint to monitor container health, check container availability, and verify the license status, including whether the license has expired.

Make sure to choose the interval between probes carefully. An interval that is too short can overload the workers and affect request processing time. An interval that is too long can delay the detection of a malfunctioning container.

See Face SDK Web API for details.

Where can I find sample clients?

See the Clients page.

How many workers do I need?

To choose the optimal number of workers, see Performance considerations.

What about personal data and the licensing service?

The licensing service is created to manage the license keys, and this is its only purpose. The web service is customer-hosted which means that all personal data remains on the customer's servers and is not communicated back to Regula.

Can I connect to the licensing service via HTTP?

Yes. If you host the SDK in an isolated private environment, you can specify an HTTP proxy via the HTTPS_PROXY env variable. The proxy will be used by the web service to connect to the licensing service. If you use your own TLS certificates, place them in the /etc/ssl/certs folder in Linux and docker envs.

Do not specify any protocol prefix in the proxy URL. Instead of HTTPS_PROXY=http(s)://host:port use HTTPS_PROXY=host:port

How to perform the licensing service health check?

To check if the service is available, use https://lic.regulaforensics.com/healthcheck or https://lic2.regulaforensics.com/healthcheck.

What if the SDK consumes too much memory?

To prevent excessive memory consumption, you can deinitialize the SDK after using it.