How to Install LogicalDOC CE on Ubuntu 22.04 LTS

LogicalDOC is an open source Document Management System (DMS) written in Java that is designed to act as a content repository with activity workflow. It has enterprise, cloud and hybrid versions, and a free community edition. 

In this post, I will be taking you through the steps of installing LogicalDOC Community Edition (CE) on Ubuntu 22.04 LTS server. 

The steps below outline how to install the software. 

Step 1: Install JDK 11

LogicalDOC CE requires Java to run, so we need to have Java Development Kit (JDK) 11 installed before we can install other dependencies. This is done with the command below.

sudo apt update

sudo apt instal openjdk-11-jdkl 

Once installation is complete, you can check the installed version by using the following command.

sudo java -version

Step 2: Install LogicalDOC Dependencies

LogicalDOC has a few dependencies. The table below illustrates what is needed and why

LibreOffice	Allows documents to converted to PDF
ImageMagick	Allows documents to be previewed without downloading
GhostScript	Allows printing to virtual devices
Tesseract	An open source OCR engine adopted by Google that can extract text from images.
Xpdf	Converts PDF to HTML format.

Install the dependencies with the command below

sudo apt install libreoffice imagemagick ghostscript tesseract-ocr xpdf

Step 3: Install MariaDB

The next step is to install a database and we will be installing MariaDB. This is accomplished by using the command below

sudo apt install mariadb-server mariadb-client

Step 4: Configure the Database

The first thing we need to do is secure our MariaDB (MySQL) installation. This is done with the command

sudo mysql_secure_installation. 

You will be asked to create a root password. Make sure to write it down, you will need it next. 

I usually select Y for all settings. However, you will need to choose based on your own preferences. Once this is done, you now proceed to logging into the database and creating a user and databases for LogicalDOC.

sudo mysql -u root -p 

Once in the database, you will use SQL to create a database, user and grant privileges to the user. This is done with the command below. 

CREATE DATABASE logicaldoc;
CREATE USER ‘ldocadmin’@’localhost’ IDENTIFIED BY ‘Password’;
GRANT ALL PRIVILEGES ON logicaldoc.* TO ‘ldocadmin’@’localhost’;
FLUSH PRIVILEGES;
\q

Step 5: Downloading and Installing LogicalDOC CE

Now that we have prepared our database and installed all the dependencies, we can proceed with downloading LogicalDOC CE and installing it on our system. 

LogicalDOC CE can be downloaded from sourceforge.net using the command

wget https://nchc.dl.sourceforge.net/project/logicaldoc/distribution/LogicalDOC%20CE%208.7/logicaldoc-community-installer-8.7.3.zip

You then need to install unzip (if not already installed). 

sudo apt install unzip

Then unzip the downloaded file. 

sudo unzip logicaldoc-community-installer-8.7.3.zip

Once the files are unzipped, run the installer file. This is done with the command

sudo java -jar logicaldoc-installer.jar  

Then follow the installation wizard. 

Once this part of the installation is complete, open your browser and continue the setup process. The default password and username is admin /admin.

http://HOST_IP:8080/setup.jsp

The repository is usually located in the LogicalDOC-Community folder. 

/LogicalDOC-Community/repository

In the Database tab, make sure the embedded button is selected and complete the setup. 

If everything when well then a message will pop up saying LogicalDOC installed correctly like the one below.

Now, you can login to LogicalDOC CE using the default admin password and username – and change your password before going operational.     

If you are intending to install an Enterprise or licensed version of LogicalDOC then there will be some changes to the installation command. In the licensed versions, installation is usually done with a bash script file (.sh) usually install.sh etc.

Anyway, I hope this post has proven helpful and please share this content with anyone who might find it helpful too.