LogicalDOC is an open source document management system (DMS) built on Java that helps organizations store, organize, and retrieve digital documents. It supports full-text search, version control, workflow automation, and access control – making it a solid choice for teams that need structured document handling without paying for proprietary solutions like SharePoint.<\/p>\n\n\n\n
This guide walks through installing LogicalDOC Community Edition 9.2<\/a> on Ubuntu 24.04 LTS with MariaDB as the database backend, Nginx as a reverse proxy, and SSL from Let’s Encrypt for production use.<\/p>\n\n\n\n Before starting, make sure you have the following in place:<\/p>\n\n\n\n Switch to root for the rest of this guide:<\/p>\n\n\n\n LogicalDOC 9.2 requires Java 21 or newer. Ubuntu 24.04 includes OpenJDK 21 in its default repositories, so installation is straightforward. If you need a detailed walkthrough, check our guide on installing Java on Ubuntu<\/a>.<\/p>\n\n\n\n After installation completes, confirm the Java version:<\/p>\n\n\n\n The output should show OpenJDK 21:<\/p>\n\n\n\n Set the JAVA_HOME environment variable so LogicalDOC can find your Java installation:<\/p>\n\n\n\n LogicalDOC stores all metadata, users, and document indexes in a relational database. MariaDB works well for this and ships in Ubuntu’s default repositories.<\/p>\n\n\n\n Enable and start the MariaDB service:<\/p>\n\n\n\n Verify MariaDB is running:<\/p>\n\n\n\n You should see the service as active (running):<\/p>\n\n\n\n Run the security hardening script to set a root password and remove test databases:<\/p>\n\n\n\n Answer the prompts as follows – set a strong root password when asked:<\/p>\n\n\n\n Create a dedicated database and user for LogicalDOC. Log into the MariaDB shell:<\/p>\n\n\n\n Run the following SQL commands to create the database, user, and grant the necessary privileges. Replace Download the LogicalDOC CE 9.2 installer from SourceForge. This is the Linux installer packaged as a zip archive containing the Java-based installer JAR file.<\/p>\n\n\n\n Install the unzip utility if not already present, then extract the installer:<\/p>\n\n\n\n Run the installer in console mode since we are working on a server without a graphical interface. The installer handles application deployment, database schema creation, and initial configuration.<\/p>\n\n\n\n The installer walks through several configuration screens. Here are the key settings to enter:<\/p>\n\n\n\n The installer creates the database tables and deploys the application. Wait for it to complete – this may take a few minutes depending on your server speed.<\/p>\n\n\n\n To manage LogicalDOC with systemd and have it start automatically on boot, create a service unit file. Open the file:<\/p>\n\n\n\n Add the following service configuration:<\/p>\n\n\n\n Reload systemd to pick up the new service file, then enable and start LogicalDOC:<\/p>\n\n\n\n Check that the service started correctly:<\/p>\n\n\n\n The output should show the service as active:<\/p>\n\n\n\n LogicalDOC takes 30-60 seconds to fully start while it initializes the application and connects to the database. You can monitor the startup progress in the logs:<\/p>\n\n\n\n LogicalDOC runs on port 8080 by default. Open your browser and navigate to your server’s IP address or hostname:<\/p>\n\n\n\n Log in with the default credentials:<\/p>\n\n\n\n Change the default admin password immediately after your first login. Go to Personal<\/strong> > Change Password<\/strong> in the top-right menu.<\/p>\n\n\n\n Running LogicalDOC behind Nginx gives you clean URLs on port 80\/443, SSL termination, and better performance for static assets. For more on Nginx setup, see our guide on installing and configuring Nginx on Ubuntu 24.04<\/a>.<\/p>\n\n\n\n Install Nginx:<\/p>\n\n\n\n Create a new Nginx virtual host configuration for LogicalDOC:<\/p>\n\n\n\n Add the following reverse proxy configuration. Replace Enable the site and remove the default Nginx configuration:<\/p>\n\n\n\n Test the Nginx configuration for syntax errors:<\/p>\n\n\n\n If the test passes, you should see this confirmation:<\/p>\n\n\n\n Restart Nginx to apply the changes:<\/p>\n\n\n\n Open the required ports in Ubuntu’s UFW firewall to allow web traffic. You need HTTP (80) and HTTPS (443) for the reverse proxy. For a deeper look at firewall management, check out our UFW firewall commands guide<\/a>.<\/p>\n\n\n\n Verify the firewall rules are active:<\/p>\n\n\n\n The output should show all three ports allowed:<\/p>\n\n\n\n Secure your LogicalDOC installation with a free SSL certificate from Let’s Encrypt. Install Certbot and the Nginx plugin:<\/p>\n\n\n\n Run Certbot to obtain and install the SSL certificate. Replace Certbot automatically modifies your Nginx configuration to handle SSL and sets up HTTP-to-HTTPS redirection. Verify the certificate was issued successfully:<\/p>\n\n\n\n You should see your domain listed with a valid certificate and expiry date:<\/p>\n\n\n\n Certbot installs a systemd timer that automatically renews certificates before they expire. Confirm the renewal timer is active:<\/p>\n\n\n\n The timer should show as active and scheduled for the next renewal check:<\/p>\n\n\n\n You can now access LogicalDOC securely at LogicalDOC Community Edition 9.2 is now running on Ubuntu 24.04 with MariaDB as the database backend, Nginx handling reverse proxy duties, and Let’s Encrypt providing SSL encryption. The setup is ready for document uploads, user management, and full-text search.<\/p>\n\n\n\n For production use, set up regular database backups with MariaDB dump schedules, monitor disk usage on the document repository directory, and consider placing the LogicalDOC is an open source document management system (DMS) built on Java that helps organizations store, organize, and retrieve digital documents. It supports full-text search, version control, workflow automation, and access control – making it a solid choice for teams that need structured document handling without paying for proprietary solutions like SharePoint. This guide walks … Read more<\/a><\/p>\n","protected":false},"author":3,"featured_media":3716,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[299,50,81],"tags":[192,574,178],"class_list":["post-3698","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-how-to","category-linux-tutorials","category-ubuntu","tag-documentation","tag-logicaldoc","tag-wiki"],"_links":{"self":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts\/3698","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/comments?post=3698"}],"version-history":[{"count":1,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts\/3698\/revisions"}],"predecessor-version":[{"id":163710,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts\/3698\/revisions\/163710"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/media\/3716"}],"wp:attachment":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/media?parent=3698"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/categories?post=3698"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/tags?post=3698"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Prerequisites<\/h2>\n\n\n\n
\n
sudo -i<\/code><\/pre>\n\n\n\nStep 1: Install Java 21 on Ubuntu 24.04<\/h2>\n\n\n\n
apt update\napt install -y openjdk-21-jdk<\/code><\/pre>\n\n\n\njava -version<\/code><\/pre>\n\n\n\nopenjdk version \"21.0.6\" 2025-01-21\nOpenJDK Runtime Environment (build 21.0.6+7-Ubuntu-124.04.1)\nOpenJDK 64-Bit Server VM (build 21.0.6+7-Ubuntu-124.04.1, mixed mode, sharing)<\/code><\/pre>\n\n\n\necho 'export JAVA_HOME=\/usr\/lib\/jvm\/java-21-openjdk-amd64' >> \/etc\/profile.d\/java.sh\nsource \/etc\/profile.d\/java.sh<\/code><\/pre>\n\n\n\nStep 2: Install MariaDB Database Server<\/h2>\n\n\n\n
apt install -y mariadb-server mariadb-client<\/code><\/pre>\n\n\n\nsystemctl enable --now mariadb<\/code><\/pre>\n\n\n\nsystemctl status mariadb<\/code><\/pre>\n\n\n\n\u25cf mariadb.service - MariaDB 10.11.8 database server\n Loaded: loaded (\/usr\/lib\/systemd\/system\/mariadb.service; enabled; preset: enabled)\n Active: active (running)<\/code><\/pre>\n\n\n\nmariadb-secure-installation<\/code><\/pre>\n\n\n\n\n
Step 3: Create LogicalDOC Database and User<\/h2>\n\n\n\n
mariadb -u root -p<\/code><\/pre>\n\n\n\nStrongPassword123<\/code> with your own secure password:<\/p>\n\n\n\nCREATE DATABASE logicaldoc CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nCREATE USER 'logicaldoc'@'localhost' IDENTIFIED BY 'StrongPassword123';\nGRANT ALL PRIVILEGES ON logicaldoc.* TO 'logicaldoc'@'localhost';\nFLUSH PRIVILEGES;\nEXIT;<\/code><\/pre>\n\n\n\nStep 4: Download LogicalDOC Community Edition<\/h2>\n\n\n\n
cd \/opt\nwget https:\/\/sourceforge.net\/projects\/logicaldoc\/files\/distribution\/LogicalDOC%20CE%209.2\/logicaldoc-community-installer-9.2.0.zip\/download -O logicaldoc-community-installer-9.2.0.zip<\/code><\/pre>\n\n\n\napt install -y unzip\nunzip logicaldoc-community-installer-9.2.0.zip<\/code><\/pre>\n\n\n\nStep 5: Run the LogicalDOC Installer<\/h2>\n\n\n\n
java -jar logicaldoc-community-installer-9.2.0.jar -console<\/code><\/pre>\n\n\n\n\n
\/opt\/LogicalDOC<\/code> or set your preferred path<\/li>\n\nlocalhost<\/code><\/li>\n\n3306<\/code><\/li>\n\nlogicaldoc<\/code><\/li>\n\nlogicaldoc<\/code><\/li>\n\nStep 6: Configure LogicalDOC as a Systemd Service<\/h2>\n\n\n\n
vi \/etc\/systemd\/system\/logicaldoc.service<\/code><\/pre>\n\n\n\n[Unit]\nDescription=LogicalDOC Document Management System\nAfter=network.target mariadb.service\nRequires=mariadb.service\n\n[Service]\nType=forking\nUser=root\nGroup=root\nEnvironment=\"JAVA_HOME=\/usr\/lib\/jvm\/java-21-openjdk-amd64\"\nExecStart=\/opt\/LogicalDOC\/bin\/logicaldoc-all start\nExecStop=\/opt\/LogicalDOC\/bin\/logicaldoc-all stop\nRestart=on-failure\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\n\n\n\nsystemctl daemon-reload\nsystemctl enable --now logicaldoc<\/code><\/pre>\n\n\n\nsystemctl status logicaldoc<\/code><\/pre>\n\n\n\n\u25cf logicaldoc.service - LogicalDOC Document Management System\n Loaded: loaded (\/etc\/systemd\/system\/logicaldoc.service; enabled; preset: enabled)\n Active: active (running)<\/code><\/pre>\n\n\n\ntail -f \/opt\/LogicalDOC\/logs\/ld.log<\/code><\/pre>\n\n\n\nStep 7: Access the LogicalDOC Web Interface<\/h2>\n\n\n\n
http:\/\/your-server-ip:8080\/logicaldoc\/<\/code><\/pre>\n\n\n\n\n
Step 8: Configure Nginx as a Reverse Proxy for LogicalDOC<\/h2>\n\n\n\n
apt install -y nginx<\/code><\/pre>\n\n\n\nvi \/etc\/nginx\/sites-available\/logicaldoc.conf<\/code><\/pre>\n\n\n\ndms.example.com<\/code> with your actual domain name:<\/p>\n\n\n\nserver {\n listen 80;\n server_name dms.example.com;\n\n client_max_body_size 100M;\n\n location \/ {\n proxy_pass http:\/\/127.0.0.1:8080;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_read_timeout 300;\n proxy_connect_timeout 300;\n proxy_send_timeout 300;\n }\n}<\/code><\/pre>\n\n\n\nln -s \/etc\/nginx\/sites-available\/logicaldoc.conf \/etc\/nginx\/sites-enabled\/\nrm -f \/etc\/nginx\/sites-enabled\/default<\/code><\/pre>\n\n\n\nnginx -t<\/code><\/pre>\n\n\n\nnginx: the configuration file \/etc\/nginx\/nginx.conf syntax is ok\nnginx: configuration file \/etc\/nginx\/nginx.conf test is successful<\/code><\/pre>\n\n\n\nsystemctl restart nginx<\/code><\/pre>\n\n\n\nStep 9: Configure UFW Firewall Rules<\/h2>\n\n\n\n
ufw allow 80\/tcp\nufw allow 443\/tcp\nufw allow ssh\nufw enable<\/code><\/pre>\n\n\n\nufw status<\/code><\/pre>\n\n\n\nStatus: active\n\nTo Action From\n-- ------ ----\n80\/tcp ALLOW Anywhere\n443\/tcp ALLOW Anywhere\n22\/tcp ALLOW Anywhere\n80\/tcp (v6) ALLOW Anywhere (v6)\n443\/tcp (v6) ALLOW Anywhere (v6)\n22\/tcp (v6) ALLOW Anywhere (v6)<\/code><\/pre>\n\n\n\nStep 10: Configure SSL with Let’s Encrypt<\/h2>\n\n\n\n
apt install -y certbot python3-certbot-nginx<\/code><\/pre>\n\n\n\ndms.example.com<\/code> with your domain and provide a valid email for renewal notices:<\/p>\n\n\n\ncertbot --nginx -d dms.example.com --non-interactive --agree-tos -m admin@example.com<\/code><\/pre>\n\n\n\ncertbot certificates<\/code><\/pre>\n\n\n\nCertificate Name: dms.example.com\n Domains: dms.example.com\n Expiry Date: 2026-06-20 (VALID: 89 days)\n Certificate Path: \/etc\/letsencrypt\/live\/dms.example.com\/fullchain.pem\n Private Key Path: \/etc\/letsencrypt\/live\/dms.example.com\/privkey.pem<\/code><\/pre>\n\n\n\nsystemctl status certbot.timer<\/code><\/pre>\n\n\n\n\u25cf certbot.timer - Run certbot twice daily\n Loaded: loaded (\/usr\/lib\/systemd\/system\/certbot.timer; enabled; preset: enabled)\n Active: active (waiting)<\/code><\/pre>\n\n\n\nhttps:\/\/dms.example.com\/logicaldoc\/<\/code>.<\/p>\n\n\n\nConclusion<\/h2>\n\n\n\n
\/opt\/LogicalDOC\/repository<\/code> folder on a dedicated partition or volume to prevent document storage from filling up the root filesystem.<\/p>\n","protected":false},"excerpt":{"rendered":"