Installation

Only for DOCTAG/own on-premise instances:

  1. Install base software

    sudo apt-get update
    sudo apt-get install openjdk-17-jre-headless
    sudo apt-get install mongodb
  2. Download latest release

    Download from https://www.doctag.de/download/

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

    Then open this URL in your browser to set up the database and root user: http://127.0.0.1:16097/install

  3. Run as systemd service

    First create a MongoDB database user (if MongoDB authentication is enabled):

    mongosh admin
    db.createUser({
      user: "docsrv",
      pwd: "PASSWORT",
      roles: [{ role: "readWriteAnyDatabase", db: "admin" }]
    })

    Then create /etc/systemd/system/docsrv.service:

    [Unit]
    Description=Docserver for serving documents
    After=network.target
    
    [Service]
    Type=simple
    WorkingDirectory=/opt/docsrv
    ExecStart=/usr/bin/java \
      -Xms256m \
      -Xmx512m \
      -XX:MaxDirectMemorySize=512M \
      -XX:MaxGCPauseMillis=50 \
      -jar /opt/docsrv/docsrv.jar \
      --dbName docsrv-@hostname \
      --dbConnection "mongodb://docsrv:PASSWORT@localhost:27017/?authSource=admin&serverSelectionTimeoutMS=5000&connectTimeoutMS=10000"
    Restart=always
    RestartSec=10
    TimeoutStartSec=300
    KillSignal=SIGTERM
    
    [Install]
    WantedBy=multi-user.target

    Replace PASSWORT with your chosen MongoDB password. Then enable the service:

    sudo systemctl daemon-reload
    sudo service docsrv start
    sudo systemctl enable docsrv.service
  4. (Optional) Cronjob for mail import

    crontab -e
    */15 * * * * curl https://<your-docserver-domain>/internal/cron > /var/log/doctag_cron.log
  5. Login and usage

    Open in your browser and login with the root user: http://127.0.0.1:16097/

For the cloud variant, use the guided setup at https://setup.doctag.de/