This section describes how to install, update and backup Kadi4Mat in a production environment using a simple, single-machine setup. This type of setup should already be sufficient for most Kadi4Mat instances.


The productive installation has currently been tested under the following Debian-based Linux distributions, which all instructions and provided scripts are based on:

  • Debian 11 (Bullseye)

  • Debian 12 (Bookworm)

  • Ubuntu 22.04 LTS (Jammy Jellyfish)

  • Ubuntu 24.04 LTS (Noble Numbat)

The required hardware for this setup may vary for each use case, especially in regards to the required storage for the database, the search index and locally stored files. As a general rule of thumb for RAM and CPU, a minimum of 16 GB RAM and a decent CPU with 8 cores should be sufficient for this type of setup.


Keep in mind that there are various security considerations to take into account when deploying Kadi4Mat in production.

There are currently two ways to perform the installation: installation via setup script and manual installation. When using the former, it is still recommended to check out the manual installation instructions, as all the necessary steps are described in much more detail, including at which log files to look when encountering errors. This is also recommended when planning to deploy a more intricate, multi-machine setup.


After the installation, please make sure to at least check out the configuration reference as well, which explains how to further configure and customize Kadi4Mat, especially with regard to user authentication.