# Oz System Lite

### Installation

* [Contact us](mailto:Info@ozforensics.com) to get the docker image archive link and download the archive
* Load the image to docker: `docker load -i <path to image tar file>`
* Run docker: `docker run -p {port}:80  -t  ozforensics/oz-api-lite:{tag}`

{% hint style="info" %}
`The container might need several minutes to start.`
{% endhint %}

### Main Parameters&#x20;

The parameters are set by environment variables when starting the Docker container.&#x20;

The following parameters are valid:

* `NUM_WORKERS` – maximum for the analyses performing at once; might be different in different cases. *Default: 16.*
* `TF_ENABLE_ONEDNN_OPTS` – used for acceleration. *Default: 1, for AMD processors, set 0.*

### Usage

Interaction with the biometric processor is based on the REST API. The HTTPS protocol is used.&#x20;

### API Access Point&#x20;

API access base URL:  **https\://{hostname}/v1/face/pattern** or **https\://{hostname}/v1/face/liveness** depending on method (please refer to [Oz API Lite methods](/oz-knowledge/guides/developer-guide/api/oz-api-lite.md#examples-of-methods)).

Where:&#x20;

* **{hostname}** – the hostname and port of the deployed biometric processor server.

**Example:** `localhost/v1/face/pattern`&#x20;

The API supports the following request content types ("Content-Type" HTTP header):

* «multipart/form-data»;&#x20;
* «application/octet-stream»;&#x20;
* «image/jpeg» or «image/png»;

### HTTP Response Codes

| Response codes            | Description                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| 200 OK                    | The method call completed successfully. The biometric processor response is included in the HTTP BODY. |
| 400 Bad Request           | The method call failed on the Client side. The error code is included in the HTTP BODY.                |
| 500 Internal Server Error | The method call failed on the biometric processor side. The error code is included in the HTTP BODY.   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge/other/old-docs/oz-modules-installation/installation-lite.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.