Install on macOS

This page is currently only available in English

Installation on macOS

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

Note

Identrix runs as a standalone command-line application on macOS. There is no installer package — you only need to download, extract and run it.

Get prerequisites

macOS has built-in support for PC/SC smart card readers, so in most cases no additional drivers need to be installed before connecting an NFC smartcard reader. If your reader is not recognized after installation, see Connect a Scanner for further steps, or contact support.

Step 1: Download Identrix

Download the latest version of Identrix for macOS from Download Identrix for macOS.

Step 2: Extract the Archive

  1. Locate the downloaded archive (e.g., Identrix-macOS.tar.gz or Identrix-macOS.zip) in your Downloads folder.

  2. Extract it from the Terminal:

tar -xvf Identrix-macOS.tar.gz

or

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

Step 3: Allow Identrix to Run

Because Identrix is not distributed through the App Store, macOS Gatekeeper may block it the first time you try to run it.

  1. If you see a message that Identrix “cannot be opened because it is from an unidentified developer” (or “Apple could not verify…”), open System Settings → Privacy & Security, scroll down to the Security section, and click Open Anyway next to the message about Identrix.

  2. Alternatively, in Finder, Control-click (right-click) the Identrix application and choose Open, then confirm that you want to open it.

  3. If you are running Identrix from the Terminal and macOS reports that the file cannot be executed, make sure it has execute permissions:

chmod +x identrix

Step 4: Running Identrix

  1. Identrix backend is a console application.
  2. The easiest way to run it for the first time is from the Terminal.
  3. Refer to Running Identrix for the available commands and options.
  4. Later you can configure Identrix to start up automatically.

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.