Install LogicalDOC on Ubuntu 20.04|18.04|16.04

In this guide, I’ll take you through the steps to install LogicalDOC Community Edition on Ubuntu 20.04/18.04/16.04 LTS server. LogicalDOC is a document management system designed for sharing documents within an organization. It also acts as a content repository, with Activity workflow and Lucene indexing. LogicalDOC is written in Java.

Follow the steps below to install and configure LogicalDOC on Ubuntu 20.04|18.04|16.04 LTS.

Step 1: Install Java 11 on Ubuntu

The version of LogicalDOC we’ll install requires Java 11 in order to work.

For Ubuntu 20.04, run:

sudo apt update
sudo apt install openjdk-11-jdk

Ubuntu 18.04/16.04:

sudo add-apt-repository ppa:linuxuprising/java
sudo apt update
sudo apt install oracle-java11-set-default

When it has been installed, you can check version using:

$ java -version
openjdk version "11.0.7" 2020-04-14
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

Step 2: Install LogicalDOC dependency packages

LogicalDOC also require the following third-party Software installed on your system

• LibreOffice: For Preview of Documents
• ImageMagick: Used to manipulate images for previewing
• GhostScript: For printing documents to a virtual device
• Tesseract: Open Source OCR engine adopted by Google
• Xpdf: This is a converter from Pdf to HTML format

Let’s install these packages on to the system:

sudo apt install libreoffice imagemagick ghostscript tesseract-ocr xpdf

Step 3: Install and Configure database

Install MariaDB database server using the guide:

Install MariaDB 10.x on Ubuntu 18.04 and CentOS 7

Install MariaDB 10.x on Ubuntu 20.04

Once the installation is installed and root password set, add the following lines to the section[mysqld] on /etc/mysql/my.cnffile.

sudo vim /etc/mysql/my.cnf

[mysql]
default-character-set = utf8

[mysqld]
character-set-server = utf8
collation-server = utf8_bin
default-storage-engine = INNODB

Restart mysql service for changes to take effect:

sudo systemctl restart mysql

Create database/user

$ mysql -u root -p

CREATE DATABASE logicaldoc;
GRANT ALL PRIVILEGES ON logicaldoc.*  TO 'logicaldoc'@'localhost' \
IDENTIFIED BY "StrongPassword";
FLUSH PRIVILEGES;
\q

Step 4: Install LogicalDOC

Download latest version of LogicalDOC from Application installers download page. The latest release as of this writing is 8.4.1

export VER="8.4.2"
wget https://s3.amazonaws.com/logicaldoc-dist/logicaldoc/installers/logicaldoc-installer-${VER}.zip

Extract the package using unzip command:

sudo apt -y install unzip
unzip logicaldoc-installer-${VER}.zip

To install LogicalDOC, execute the command from the command line:

chmod +x install.sh
sudo ./install.sh

When asked for database settings, provide as configured on step 3

Command line arguments: 
Select your language
0  [x] eng
1  [ ] ita
2  [ ] spa
3  [ ] fra
4  [ ] deu
Input selection: 
0

──────────────────────────────────────────────────────────────────────────
Welcome
──────────────────────────────────────────────────────────────────────────

Welcome to the installation of LogicalDOC 8.4.2!
This software is developed by: 
 - LogicalDOC <[email protected]>
The homepage is at: https://www.logicaldoc.com

Press 1 to continue, 2 to quit, 3 to redisplay
1

License
Press 1 to accept, 2 to reject, 3 to redisplay
1
Select target path [/LogicalDOC] 
──────────────────────────────────────────────────────────────────────────
Select Installation Packages
──────────────────────────────────────────────────────────────────────────

Select the packs you want to install:

  [x] Pack 'Base' required
Done!

Press 1 to continue, 2 to quit, 3 to redisplay
1

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Installation
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

====================
Installation started
Framework: 5.1.3-84aaf (IzPack)
Platform: ubuntu_linux,version=5.4.0-28-generic,arch=x64,symbolicName=null,javaVersion=11.0.7
[ Starting to unpack ]
[ Processing package: Base (1/1) ]
[ Unpacking finished ]
Installation finished
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
User Data
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

Registration

Activation Code [] 
Name [] 
Organization [] 
Email [] 

Web site [] 
http://logicaldoc.examle.com

Press 1 to continue, 2 to quit, 3 to redisplay
1
Thu Sep 13 00:03:31 EAT 2018 - INFO - Detected Java architecture 32bit

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
User Data
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

Database
Engine
0  [x] MySQL / MariaDB (suggested choice for production)
1  [ ] Oracle
2  [ ] SQL Server
3  [ ] PostgreSQL
4  [ ] Embedded (for trial only, not for production)
Input selection: 
0
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
User Data
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

Database
Username [] 
logicaldoc
Password
**************

Server name/IP [localhost] 
Server port [3306] 
Database [logicaldoc] 
Instance [] 

  [ ] Manual specification of the database connection URL
Enter 1 to select, 0 to deselect: 
1
Press 1 to continue, 2 to quit, 3 to redisplay
1

Step 5: Post-installation Settings

You need to copy the startup service into your system initialization directory to be able to start LogicalDOC at server bootstrap:

sudo cp /LogicalDOC/bin/logicaldoc-all.service /etc/systemd/system
sudo systemctl daemon-reload

Start and enable the service to start on boot:

sudo systemctl enable logicaldoc-all
sudo systemctl start logicaldoc-all

Open LogicalDOC Web UI using your default browser: http://localhost:8080/.

Login with the account admin with password admin for the first time.

For further reading on how to administer LogicalDOC, check user and Admin guides.