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
-
Open https://downloads.regulaforensics.com/repo/ubuntu/pool/stable/r/regula-document-reader-webapi/, browse the required package dir, and download the
.debfile 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 -
Install Document Reader Web API:
sudo dpkg -i <package>.deb
-
Open https://downloads.regulaforensics.com/repo/debian/pool/stable/r/regula-document-reader-webapi/, browse the required package dir, and download the
.debfile 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 -
Install Document Reader Web API:
sudo dpkg -i <package>.deb
-
Open https://downloads.regulaforensics.com/repo/centos/x86_64/stable/Packages/ and download the
.rpmfile for the Document Reader Web API version you want to install:wget https://downloads.regulaforensics.com/repo/centos/x86_64/stable/Packages/<package>.rpm -
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