Install on Linux

This page is currently only available in English

Installation on Linux

This document provides step-by-step instructions for installing Identrix on Linux.

Note

this was written based on Ubuntu 20.04 and higher

Get prerequisites

The following steps are required to install Identrix on Linux:

Step 1: Install required packages

If not yet available install the following packages

sudo apt install pcscd pcsc-tools libpcsclite1 libserial1

Step 2: Update Smartcard Reader identification

The Smartcard Reader must be identified by the system. To do this, follow the instructions below:

  1. Change to the following directory **
cd /usr/lib/pcsc/drivers/ifd ccid.bundle/Contents
  1. open the file Info.plist in your favorite editor.

  2. Search for <key>ifdVendorID</key>. In this section, the supported USB vendor IDs are listed. Scroll to the end of the list and append the entries with values 0x1FFA and 0x2B78 as indicated below:

<key>ifdVendorID</key>
<array>
  <string>0x072F</string>
  <string>0x09C3</string>
  <string>0x09C3</string>
  .
  .
  .
  <string>0x1FFA</string>
  <string>0x2B78</string>
  <string>0x2B78</string>
  <string>0x2B78</string>
</array>
  1. Search for <key>ifdProductID</key>. In this section, the corresponding USB product IDs are listed. Scroll to the end of the list and append the entries with values 0x0002, 0x0041, 0x0042 and 0x0043 as indicated below:
<key>ifdProductID</key>
<array>
  <string>0x90CC</string>
  <string>0x0013</string>
  <string>0x0014</string>
  .
  .
  .
  <string>0x0002</string>
  <string>0x0041</string>
  <string>0x0042</string>
  <string>0x0043</string>
</array>
  1. Search for <key>ifdFriendlyName</key>. In this section, the corresponding friendly product names are listed. Scroll to the end of the list and append the indicated entries as follows:
<key>ifdFriendlyName</key>
<array>
  <string>ACS ACR 38U-CCID</string>
  <string>ActivIdentity USB Reader V3</string>
  <string>ActivIdentity Activkey_Sim</string>
  .
  .
  .
  <string>ELYCTIS CL Reader</string>
  <string>ELYCTIS ID READER 111</string>
  <string>ELYCTIS ID READER 112</string>
  <string>ELYCTIS ID READER 121</string>
</array>
  1. Save the file.

  2. Reboot the system.

Step 3: Ensure serial device permissions

If you do not want to have to run identrix as root, add the relevant user to the dialout group so it has read/write access to the serial devices.:

sudo usermod -a -G dialout $USER

Step 4: Install Identrix

  1. Download the latest version of Identrix from Download Identrix for Linux.

  2. Extract the downloaded archive:

tar -xvf Identrix-Linux.tar.gz

or

unzip Identrix-Linux.zip
  1. Navigate to the extracted directory:
cd Identrix-Linux

Basic extraction / installation is now finished. Please choose your next steps.

Next Steps

Install Optional Extra’s:

If you need additional image conversion options or other features, you can install the optional extras using the Image Conversion guide.

Connect a scanner:

Once you have installed Identrix, you can connect to a scanner using the Connect a Scanner guide.

First Time Setup:

After installation, proceed to the First Time Setup to configure Identrix and start using it for your identity document processing needs.

Running Identrix:

Once you have completed the first time setup, you can start Identrix using the Running Identrix guide.