FacePlugin
Get in Touch
Linux

Face Liveness Detection SDK for Linux & Docker

Run passive face liveness detection in a single Docker container on your own Linux server, exposed as a local REST API. No images or liveness results ever leave your infrastructure.

Get in Touch View on GitHub
CPU-only, no GPU requiredREST API via DockerNo per-call fees
Young bearded man portrait
Live person
Liveness ✓
Requirements

What You Need to Run It on Linux

These are the exact minimum and recommended requirements published in the FaceLivenessDetection-Docker repository — check the repo directly for the latest version, since SDK requirements can change between releases.

Host OSLinux with Docker Engine (Ubuntu 22.04 / 24.04 recommended)
CPU / RAM / Disk (min)2 cores / 4 GB / 4 GB
CPU / RAM / Disk (recommended)4 cores / 8 GB / 8 GB
Architecturelinux/amd64, CPU-only (no GPU build)
Quick Start

Install and Activate

Install the SDK, then activate it with a license key before calling any liveness function – every platform follows this same activate-then-initialize pattern.

  • Pull and run the Docker image on your Linux server: docker pull faceplugin/face-liveness:latest.
  • Check GET /api/health to confirm the container is up.
  • Get your machine code, send it to FacePlugin, then activate with POST /api/activate and your license key.
bash
# Health check
curl -s http://127.0.0.1:8084/api/health

# Activate with your license key
curl -s -X POST http://127.0.0.1:8084/api/activate \
  -H "Content-Type: text/plain" \
  --data-binary @license.txt

# Run a liveness check
curl -s -X POST http://127.0.0.1:8084/api/liveness \
  -H "Content-Type: application/json" \
  -d '{"image": "<base64-jpeg>"}'
Licensing

How Licensing Works

Licenses are offline and bound to a machine code. The API starts even before activation, but liveness checks stay restricted until you activate with a key tied to that machine code – Docker and local-host installs get different machine codes, so request a key for whichever environment runs in production.

FAQ

Frequently Asked Questions

Does the Linux SDK send biometric data to the cloud?

No. Every liveness check runs on your own server or directly on the device, depending on the platform – images never leave an environment you control.

How is the SDK licensed?

Licenses are offline and bound to a machine code, application ID, or bundle ID depending on the platform. Contact FacePlugin with that identifier to receive a license key – there are no per-call or per-check fees once licensed.

Where can I see the full source and open an issue?

The Linux integration is maintained publicly on GitHub at github.com/Faceplugin-ltd, where you can browse the code, file issues, and track releases.

Related

Pairs Well With

Windows

Offline liveness checks via a local REST API.

Face Liveness Detection SDK

The full product overview across every platform.

Face Recognition SDK

Precise 1:1 and 1:N face matching to pair with liveness.

Ready to Add Liveness Detection to Your Linux App?

Talk to our team to get a license key and a 15-day evaluation period started.

Contact Sales Explore the SDKs