You can support us by downloading this article as PDF from the Link below. Download the guide as PDF

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

Add:

[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.

You can support us by downloading this article as PDF from the Link below. Download the guide as PDF