Installation

Only for DOCTAG/own on-premise instances

Note

The hosted service DOCTAG/cloud has an easy step-by-step start-up procedure under setup.doctag.de

Installation on Debian/Ubuntu

1. Installing the basic technology

To install the required software use

sudo apt-get install openjdk-14-jre

sudo apt-get install mongodb

2. Download latest release of DOCTAG/own

Load the release from https://www.doctag.de/download/

Example command:

wget https://www.doctag.de/download/docsrv-2023-11-29.jar

# Rename file
mv docsrv-2023-11-29.jar docsrv.jar

java -jar docsrv.jar

Now visit http://127.0.0.1:16097/install in your browser to initially setup database hostname and root user.

3. Running as systemd service

Create a systemd service file named /etc/systemd/system/docsrv.service with the following content:

[Unit]
Description=Docserver for serving documents
After=network.service

[Service]
Restart=always
RestartSec=10
TimeoutSec=300
# Please customize the working directory
WorkingDirectory=/root/ 
ExecStart=/usr/bin/java -Xms256m -Xmx512m -XX:MaxDirectMemorySize=512M -XX:MaxGCPauseMillis=50 -jar docsrv.jar


[Install]
WantedBy=multi-user.target

Reload systemd and start Doctag instance

sudo systemctl daemon-reload
sudo service docsrv start

To view the log output please execute

sudo journalctl -u docsrv.service -f

To automatically boot service on system start

sudo systemctl enable docsrv.service

4. Create cronjob for automatic mail import (if required)

The import of documents can be automated using the automatic mail import function. The mail import can be executed at a desired interval using the following cron job:

crontab -e
*/15 * * * * curl https://<your Docserver domain>/internal/cron > /var/log/doctag_cron.log

In this example, the job is executed every 15 minutes.

5. Ready to login and work

Now DOCTAG/own is ready to work. Open http://127.0.0.1:16097/ in your browser and login with the root user you created in step 2.

For correct operation of the server, the server needs to have a valid SSL certificate and a domain. Please refer to the chapter Donain and SSL to get more information.