Skip to content

Linux

How to install the Document Reader Web API.

Supported OS

To install Document Reader Web API, you need a 64-bit version of one of the following OS versions:

Ubuntu

  • Ubuntu 16.04 (Xenial Xerus)
  • Ubuntu 18.04 (Bionic Beaver)
  • Ubuntu 20.04 (Focal Fossa)
  • Ubuntu 22.04 (Jammy Jellyfish)

Debian

  • Debian 9 (Stretch)
  • Debian 10 (Buster)
  • Debian 11 (Bullseye)

CentOS

  • CentOS 7
  • CentOS 8

Info

Document Reader Web API is supported on the x86_64 or (amd64) architectures.

Install Document Reader Web API

Using Repository

Set up the repository

1. Update the apt package index and install packages to allow apt using the repository over HTTPS:

sudo apt-get update
sudo apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

2. Add the Regula official GPG key:

curl -fsSL https://downloads.regulaforensics.com/repo/ubuntu/regula.gpg | sudo gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/regula.gpg --import
sudo chmod 644 /etc/apt/trusted.gpg.d/regula.gpg

3. Use the following command to set up the stable repository.

sudo add-apt-repository \
"deb [arch=amd64] https://downloads.regulaforensics.com/repo/ubuntu \
$(lsb_release -cs) \
stable"

Install Document Reader Web API

1. Update the apt package index and install the latest version of Document Reader Web API, or go to the next step to install a specific version:

sudo apt-get update
sudo apt-get install regula-document-reader-webapi

2. To install a specific version of Document Reader Web API, list the available versions in the repo, then select and install the required version:

a. List the versions available in your repo:

apt-cache madison regula-document-reader-webapi

b. Install a specific version using the version string from the second column:

sudo apt-get install regula-document-reader-webapi=<VERSION>

Set up the repository

1. Update the apt package index and install packages to allow apt using the repository over HTTPS:

sudo apt-get update
sudo apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

2. Add the Regula official GPG key:

curl -fsSL https://downloads.regulaforensics.com/repo/debian/regula.gpg | sudo apt-key add -

3. Use the following command to set up the stable repository:

sudo add-apt-repository \
"deb [arch=amd64] https://downloads.regulaforensics.com/repo/debian \
$(lsb_release -cs) \
stable"

Install Document Reader Web API

1. Update the apt package index and install the latest version of Document Reader Web API, or go to the next step to install a specific version:

sudo apt-get update
sudo apt-get install regula-document-reader-webapi

2. To install a specific version of Document Reader Web API, list the available versions in the repo, then select and install the required version:

a. List the versions available in your repo:

apt-cache madison regula-document-reader-webapi

b. Install a specific version using the version string from the second column:

sudo apt-get install regula-document-reader-webapi=<VERSION>

Set up the repository

Install the yum-utils package (which provides the yum-config-manager utility) and set up the stable repository:

sudo yum install -y yum-utils
sudo yum-config-manager \
    --add-repo \
    https://downloads.regulaforensics.com/repo/centos/regula.repo

Install Document Reader Web API

1. Install the latest version of Document Reader Web API or go to the next step to install a specific version:

sudo yum install regula-document-reader-webapi

2. To install a specific version of Document Reader Web API, list the available versions in the repo, then select and install the required version:

a. List the versions available in your repo:

sudo yum list regula-document-reader-webapi --showduplicates | sort -r

b. Install a specific version by its fully qualified package name:

sudo yum install regula-document-reader-webapi-<VERSION>

From Package

  1. Open https://downloads.regulaforensics.com/repo/ubuntu/pool/stable/r/regula-document-reader-webapi/, browse the required package dir, and download the .deb file for the Document Reader Web API version you want to install:

    wget https://downloads.regulaforensics.com/repo/ubuntu/pool/stable/r/regula-document-reader-webapi/<package>.deb
    
  2. Install Document Reader Web API:

    sudo dpkg -i <package>.deb
    
  1. Open https://downloads.regulaforensics.com/repo/debian/pool/stable/r/regula-document-reader-webapi/, browse the required package dir, and download the .deb file for the Document Reader Web API version you want to install:

    wget https://downloads.regulaforensics.com/repo/debian/pool/stable/r/regula-document-reader-webapi/<package>.deb
    
  2. Install Document Reader Web API:

    sudo dpkg -i <package>.deb
    
  1. Open https://downloads.regulaforensics.com/repo/centos/x86_64/stable/Packages/ and download the .rpm file for the Document Reader Web API version you want to install:

    wget https://downloads.regulaforensics.com/repo/centos/x86_64/stable/Packages/<package>.rpm
    
  2. Install Document Reader Web API:

    sudo rpm -ivh <package>.rpm
    

Set Up License

To access all the capabilities of Regula Document Reader Web API, a license is required.

To obtain the production license or other purchasing information, please submit an inquiry and our sales team will contact you shortly.

Info

Assuming that the regula.license file is located at your user's home directory "$HOME/regula.license"

1. Copy the regula.license file to the following folder:

sudo cp -ar ~/regula.license /opt/regula/document-reader-webapi/extBin/unix_x64/

Please make sure that the regula.license file has read, write, and execute file permissions. If not, grant them:

chmod 764 /opt/regula/document-reader-webapi/extBin/unix_x64/regula.license

And the license file ownership is regula:regula for group and owner group. If not, change file owner:

sudo chown regula:regula /opt/regula/document-reader-webapi/extBin/unix_x64/regula.license

2. Restart the Document Reader Web API service:

sudo systemctl restart regula-document-reader-webapi.service