Media Server 25.4
Media Server Help

# MaxFaces

The number of face identities in the database(s) that you want to run face recognition against.

If the value of `MaxFaces` is less than the number of faces in the database, the `process` action does not start. If you expect faces to be added to the database while the face recognition task runs, you should set `MaxFaces` to the expected total number of faces after the additional faces have been added.

The channels used to run a `process` action are determined as follows:

- If your configuration includes tasks that require a visual license, such as optical character recognition or object detection, the `process` action does not start unless the correct number of visual channels are available. Media Server requires one visual channel for all visual analytics including face detection and recognition with up to 250,000 faces. If you want to run face detection and recognition against a database of more than 250,000 faces, Media Server requires an additional visual channel for each additional 250,000 faces. For example, running face detection and recognition with a database of 700,000 faces requires three visual channels.
- If your configuration only includes tasks that require a surveillance license, Media Server can use surveillance channels. Media Server requires one surveillance channel for face detection and recognition with up to 250 faces. If you want to run face detection and recognition against a database of more than 250 faces, Media Server requires an additional surveillance channel for each additional 250 faces. For example, running face detection and recognition with a database of 700 faces requires three surveillance channels. If there are insufficient surveillance channels available but a visual channel is available, then Media Server uses a visual channel instead.

Type: | Integer
Default: | 250
Required: | No
Configuration Section: | TaskName
Example: | `MaxFaces=500`
See Also: | Channels Configuration Parameters

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.4

Topic Title: MaxFaces