> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Online protection

> Install ABBYY FineReader Engine for development on Linux as a non-root user in automatic mode using an Online License token file.

Online protection uses a password-protected file that contains the license parameters. In this case, license activation is not required.

<Accordion title="Standalone license">
  In this scenario, you are about to develop an application that uses ABBYY FineReader Engine library and to be deployed to a cloud instance, private virtual machine, or a local workstation. The installation is performed via the command line, without any interaction with the user.

  You will need:

  * an Online License token file (named like SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).

  * the password to the license token file.

  * your Customer Project ID.

  Follow the instructions:

  1. Run the %archive\_name%.sh as non-root user.
  2. Specify the following parameters in the command line:
     * The path to the folder where the ABBYY FineReader Engine library will be installed.
     * Your Customer Project ID.
     * The parameter of the developer installation.
     * The path to a folder for storing the licensing data (it can be any folder in the /home directory, while excluding the /tmp directory).
     * The full path and the password to the Online License token file.

  The example of command line:

  ```
  %archive_name%.sh -- --install-dir "<folder path>" 
  --project-id "<Customer Project ID>" --license-path "<file path>" --license-password "<password>" 
  --licenses-folder "<folder path>" --developer-install
  run "<FRE_installation_directory>/Bin/ServiceWrapper
  <FRE_installation_directory>/CommonBin/Licensing/start_licensing_service.sh"
  run "LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone"
  ```

  1. Wait for installation to complete.

  <Warning>
    After installing ABBYY FineReader Engine, the folder for storing the licensing data can be changed in LicensingSettings.xml. See the example in [Working with the LicensingSettings.xml File](/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file) article.
  </Warning>

  4. Start the Licensing Service via the command:

  as a daemon

  or as an application

  An Online License does not need activation: license information is received at the application run-time from ABBYY Online licensing services. To authorize, the application sends a license token file and a license password. You will need to place the token file where it is expected by the application. This location must be specified by the developer (default is a folder set for --licenses-folder parameter during installation).

  Note that:

  * Internet connection is required when the application is running.

  * Connections to \*.abbyy.com on port 443 (HTTPS) are allowed. If the connection is lost, the application will stop functioning after a certain reconnection timeout is exceeded. The synchronization period and the reconnection timeout are specific parameters of each Online License.

  * GoDaddy root certificate should be installed. See the detailed information about the certificate on the GoDaddy [website](http://www.godaddy.com/).
</Accordion>

<Accordion title="Network license">
  In this scenario, you are about to develop an application that uses ABBYY FineReader Engine library on a workstation connected to the license server through a network. The installation is performed via the command line, without any interaction with the user.

  You will need:

  * an Online License token file (named like SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).

  * the password to the license token file.

  * your Customer Project ID.

  * the DNS name or IP-address of the license server.

  Follow the instructions:

  1. Install the Licensing Service on the license server, as described in [Installing the Licensing Service](/fine-reader/engine/distribution/distribution-linux/activating-the-library-linux/installing-the-licensing-service-on-linux).

  Use ABBYY FineReader Engine and Licensing Service from the same package. Otherwise, compatibility is not guaranteed.

  2. Install the library on the workstations:

  3. Run the %archive\_name%.sh as non-root user.

  4. Specify the following parameters in the command line:
     * The path to the folder where the ABBYY FineReader Engine library will be installed.
     * Your Customer Project ID.
     * IP-address of the license server with the Licensing Service installed.
     * The path to a folder for storing the licensing data (it can be any folder in the /home directory, while excluding the /tmp directory).
     * The parameter of the developer installation.
     * The full path and the password to the Online License token file.

  The example of command line:

  ```
  %archive_name%.sh -- --install-dir "<folder path>" 
  --project-id "<Customer Project ID>" --service-address "<address>" --license-path "<file path>" --license-password "<password>"
  --licenses-folder "<folder path>" --developer-install
  ```

  3. Wait for installation to complete.

  <Warning>
    After installing ABBYY FineReader Engine, the folder for storing the licensing data can be changed in LicensingSettings.xml. See the example in [Working with the LicensingSettings.xml File](/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file) article.
  </Warning>

  An Online License does not need activation: license information is received at the application run-time from ABBYY Online licensing services. To authorize, the application sends a license token file and a license password. You will need to place the token file where it is expected by the application. This location must be specified by the developer (default is a folder set for --licenses-folder parameter during installation).

  Note that:

  * Internet connection is required when the application is running.

  * Connections to \*.abbyy.com on port 443 (HTTPS) are allowed. If the connection is lost, the application will stop functioning after a certain reconnection timeout is exceeded. The synchronization period and the reconnection timeout are specific parameters of each Online License.

  * Port 3023 must be opened on the license server for its connection to the workstations. The only supported connection protocol is Sockets.

  * GoDaddy root certificate should be installed on the license server with the Licensing Service installed. See the detailed information about the certificate on the GoDaddy [website](http://www.godaddy.com/).
</Accordion>