(Last Updated On: September 13, 2018)

In this guide, I’ll take you through the steps to install LogicalDOC Community Edition on Ubuntu 18.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 18.04 / Ubuntu 16.04 LTS.

Step 1: Install Java JDK 8

LogicalDOC requires Java JDK 1.8 in order to work properly. Install it using the following commands

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer

To install Java Open JDK 8 instead, run:

sudo apt install openjdk-8-jdk

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

$ java -version
java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)

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-get 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

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

export VER="8.1"
https://sourceforge.net/projects/logicaldoc/files/sources/sources-8.x/logicaldoc-${VER}-src.zip
unzip logicaldoc-${VER}-src.zip

For commercial version:

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

Extract the package using unzip command

unzip logicaldoc-installer-${VER}.zip

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

sudo java -jar logicaldoc-installer.jar

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.1!
This software is developed by: 
 - LogicalDOC <support@logicaldoc.com>
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
WARNING: Failed to format pattern=Framework: 5.1.3-SNAPSHOT-${buildNumber} (IzPack), for key=installer.version
installer.version
Platform: ubuntu_linux,version=4.15.0-30-generic,arch=x64,symbolicName=null,javaVersion=1.8.0_181
[ 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

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