How to Install LogicalDOC CE on Ubuntu 22.04 LTS

Looking to set up LogicalDOC Community Edition (CE) on your Ubuntu 22.04 LTS server? This open-source document management system is perfect for organizing and managing your documents efficiently. In this step-by-step guide, we’ll walk you through the process of installing LogicalDOC CE on Ubuntu 22.04 LTS, ensuring a smooth setup for beginners and seasoned users alike.

What is LogicalDOC CE?

LogicalDOC CE is a free, open-source document management system designed to help businesses and individuals store, manage, and track electronic documents. With features like version control, full-text search, and user access management, it’s a powerful tool for streamlining document workflows.

Prerequisites

Before we dive into the installation process, ensure you have the following:

• A server running Ubuntu 22.04 LTS with root or sudo privileges.
• At least 4GB of RAM and 20GB of free disk space.
• Java Development Kit (JDK) 11 installed.
• A database server (PostgreSQL or MySQL recommended).
• A stable internet connection.
• Basic knowledge of Linux terminal commands.

Step-by-Step Guide to Install LogicalDOC CE on Ubuntu 22.04 LTS

Follow these steps to get LogicalDOC CE up and running on your Ubuntu server.

Step 1: Update Your System and Install Dependencies

Ensure your Ubuntu system is up to date to avoid compatibility issues.

sudo apt update && sudo apt upgrade -y

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 2: Install Java Development Kit (JDK) 11

LogicalDOC CE requires JDK 11. Install it using the following commands:

sudo apt install openjdk-11-jdk -y

Verify the installation:

java -version

You should see output confirming JDK 11 is installed.

Step 3: Install and Configure MariaDB

LogicalDOC CE works well with MariaDB. Install it with:

sudo apt install mariadb-server mariadb-client -y

Start and enable the MariaDB service:

sudo systemctl start mariadb
sudo systemctl enable mariadb

Secure the installation and create a database and user for LogicalDOC:

sudo mysql_secure_installation

Log into MariaDB:

sudo mysql -u root -p

Run the following commands to create the database and user:

CREATE DATABASE logicaldoc;
CREATE USER 'logicaldocuser'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON logicaldoc.* TO 'logicaldocuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 4: Download LogicalDOC CE

Download the latest LogicalDOC CE installer from the official website or SourceForge.

wget https://sourceforge.net/projects/logicaldoc/files/latest/download -O logicaldoc-installer.zip

Unzip the downloaded file:

unzip logicaldoc-installer.zip -d logicaldoc-installer

Step 5: Run the LogicalDOC Installer

Navigate to the unzipped folder and start the installer:

cd logicaldoc-installer
sudo bash install.sh

Follow the on-screen prompts to configure:

• Installation directory: Choose a location (e.g., /opt/logicaldoc).
• Database settings: Select MariaDB and enter the database details (logicaldoc, logicaldocuser, your_secure_password).
• Admin credentials: Set up the admin username and password.

Step 6: Start LogicalDOC CE

Once the installation is complete, start the LogicalDOC service:

sudo /opt/logicaldoc/logicaldoc.sh start

Step 7: Access and Complete LogicalDOC CE Setup

Open a web browser and navigate to:

http://your_server_ip:8080/setup.jsp

Log in using the admin credentials you set during installation. You’re now ready to complete the LogicalDoc setup.

On the Repository tab make sure the repository is located in the LogicalDoc-Community folder. 

/LogicalDOC-Community/repository

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

A message will be appear after the successful completion of the setup.

Step 8: Access

Open a web browser and navigate to:

http://your_server_ip:8080

Log in using the admin credentials you set during installation. You’re now ready to explore LogicalDOC’s features!

Troubleshooting Tips

• Port 8080 is blocked: Ensure your firewall allows traffic on port 8080:sudo ufw allow 8080
• Java version issues: Confirm JDK 11 is active by running java -version.
• Database connection errors: Double-check the database name, user, and password in the LogicalDOC configuration.

Why Choose LogicalDOC CE?

LogicalDOC CE is a cost-effective solution for businesses seeking a robust document management system without licensing fees. Its features include:

• Document Versioning: Track changes and revert to previous versions.
• Full-Text Search: Quickly find documents using keywords.
• User Permissions: Control access to sensitive documents.
• Web-Based Interface: Access your documents from anywhere.

Conclusion

Installing LogicalDOC CE on Ubuntu 22.04 LTS is straightforward with the right steps. By following this guide, you’ll have a fully functional document management system ready to streamline your workflow. Have questions or run into issues? Drop a comment below, and we’ll help you out!

Happy document managing!