Skip to main content

Choosing your installation

To identify the best installation help for you, you’ll need to answer a few questions. First, why are you installing the library?
  • If you are going to develop a new application that uses the library, you need a Developer installation.
  • If you have developed an application that uses the library, you need a Runtime installation on the end user computer.
Both installation types require root permissions and running service as root. If you would like to install and run ABBYY FineReader Engine without root privileges, check out the Non-root installation section.

Installation type

Next, which installation type do you need?
  • Standalone installation is intended for when your application is running on just one local computer; the license information will be kept on the same computer.
  • Network installation allows you to store the licenses on a remote server and distribute them between the workstations as needed.

Installation method

Then, which installation method will you use?
  • Automatic installation - uses the built-in ABBYY command-line installer
  • Installation wizard - uses the setup assistant
  • Manual installation - copy the files manually/write your own script to do it
Manual installation mode can be useful if your application requires a specific functionality subset, and you want to save disk space by omitting all unnecessary resource files.

License Protection

Finally, which license protection type do you have? As described under Activation, two types of protection are available:
  • online protection — connection with ABBYY Online licensing service over the Internet for license usage
  • software protection — a serial number requiring activation
There are minor differences in the installation instructions, and each scenario is described for these protection types.

Installation scenarios

Now that you have the necessary information, use the table below to choose your installation scenario.

Installation Type

Mode of Library Installation

Using wizard

Automatic

Manual

Developer

  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license

Runtime

  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license

Installation Type

Mode of Library Installation

Using wizard

Automatic

Developer, non-root

  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license

Runtime, non-root

  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
  1. Online protection
    • Standalone license
    • Network license
  1. Software protection
    • Standalone license
    • Network license
For the Red Hat-like systems installation of FineReader Engine can be performed using Red Hat Package Manager.

ABBYY FineReader Engine in a native environment

You may run ABBYY FineReader Engine inside two separate Docker containers:
  • The first one contains FineReader Engine
  • The second one contains the Licensing Service.
See details in Running ABBYY FineReader Engine 12 inside a Docker container.

Next Steps

All of the ABBYY FineReader Engine (FRE) installation scenarios for Linux provided in this section, except the developer installation, follow the same basic process:
  1. First, install FRE on the workstation.
  2. Next, install the Licensing Service.
  3. Finally, set up the license which permits you to use the library.
To install, you will need…
  • For a Network license type: Your network license server connection details.
  • For Online license protection: An Online License token file and the password to this file. We recommend that you install the token file with the library.
  • For Software license protection: the serial number of your license.
The FRE folder structure after automatic installation contains:

Folder name

Description

<FRE_installation_directory>

A folder with the FRE files specified during installation.

<FREngineDataFolder>

A folder for storing the user-specific data. By default, %ProgramData%\ABBYY\SDK\12\FineReader Engine.

<LicensesFolder>

A folder for storing the Licensing Service files. After installation, It can be specified via the LicensingSettings.xml file or via API. By default, %ProgramData%\ABBYY\SDK\12\Licenses.

<FREngineTempFolder>

A folder for storing the ABBYY FineReader Engine temporary files. By default, %TEMP%\ABBYY FineReader Engine 12.

To change the paths to <FREngineDataFolder>, <LicensesFolder> and <FREngineTempFolder> folders, use the InitializeEngine function.