Run the Docker Container

Knomi Face Liveness Docker images are hosted on Dockerhub. Images can be downloaded using a Docker Compose file to manage them or individually.

Using Docker Compose

Download the hosted docker_compose.yml file from https://docs.knomi.aware.com/face_liveness/docker_compose.yml.

Run the Docker compose command:

docker compose up

Manual Download

Run the following command to download the Docker images for the Knomi Face Liveness and Device Metric servers:

docker pull awareknomi/face-liveness:5.0.1
docker pull awareknomi/device-metrics:1.3.1

Run the “docker images” command to verify that a Docker image was successfully pulled:

bash-4.2$ docker images
REPOSITORY                              TAG        IMAGE ID       CREATED        SIZE
awareknomi/face-liveness:<version>      <version>  a5183477a249   18 hours ago   1.5GB
centos

Start the container as follows. It will create and start the container as well as start the Knomi Face Liveness REST server inside the container:

docker run -it -p 8086:8086 --name knomifaceliveness awareknomi/face-liveness

You can query the “/version” endpoint from the command line of the Docker host to ensure it is running correctly:

curl http://localhost:8086/faceliveness/version