Requirements

Qisutu 1.0.2 is installed on a Linux server. System preparation is performed as root because it configures packages, Apache configurations, systemd services, users, and file permissions.

Supported systems

The recommended reference platform is Ubuntu Server LTS. The supplied install.sh also provides dedicated installation paths for Debian, RHEL, Rocky Linux, AlmaLinux, CentOS, Fedora, openSUSE, and SLES. An unknown distribution is not silently treated as Ubuntu; the script stops with a clear error message.

Pre-installation checks

Before starting, make sure the following requirements are met:

  • Root access or a root shell

  • Network access to the distribution’s package repositories

  • Working name resolution and an accessible web server

  • An installation path without spaces

  • Sufficient storage for the application, database, attachments, logs, and backups

  • A separate database or unique instance identifier for each installation

OAuth2 connections to Microsoft 365 or Google later require a publicly accessible HTTPS base URL. A plain HTTP address is sufficient for an initial local installation, but should not be used in production.

Required software

The installation script installs or checks Apache, MariaDB or the required MySQL client tools, Perl, and the Perl modules required for the database, email, LDAP, TLS, and OAuth. These packages therefore do not need to be collected and installed individually in advance.

Existing server

Before installation, check for existing custom Apache VirtualHosts, firewall rules, SELinux policies, or database policies. Qisutu creates instance-specific configurations but does not replace intentionally different operator configurations.