Requisitos

O Qisutu 1.0.2 é instalado em um servidor Linux. A preparação do sistema é executada como root porque configura pacotes, configurações do Apache, serviços systemd, usuários e permissões de arquivos.

Sistemas suportados

A plataforma de referência recomendada é o Ubuntu Server LTS. O install.sh fornecido também possui caminhos de instalação próprios para Debian, RHEL, Rocky Linux, AlmaLinux, CentOS, Fedora, openSUSE e SLES. Uma distribuição desconhecida não é tratada silenciosamente como Ubuntu; o script termina com uma mensagem de erro compreensível.

Verificações preliminares

Antes de começar, as seguintes condições devem ser atendidas:

  • Acesso root ou shell de root

  • Acesso de rede aos repositórios de pacotes da distribuição

  • Resolução de nomes funcional e servidor web acessível

  • Um caminho de instalação sem espaços

  • Espaço suficiente para programa, banco de dados, anexos, logs e backups

  • Um banco de dados próprio ou identificador de instância exclusivo por instalação

Para conexões OAuth2 com Microsoft 365 ou Google será necessária posteriormente uma URL base HTTPS acessível externamente. Um endereço apenas HTTP basta para uma instalação local inicial, mas não deve ser usado em produção.

Software necessário

O script de instalação instala ou verifica Apache, MariaDB ou as ferramentas cliente MySQL necessárias, Perl e os módulos Perl exigidos para banco de dados, e-mail, LDAP, TLS e OAuth. Portanto, não é preciso procurar os pacotes individualmente antes.

Servidor existente

Antes da instalação, verifique se já existem VirtualHosts próprios do Apache, regras de firewall, políticas SELinux ou políticas de banco de dados. O Qisutu cria configurações específicas da instância, mas não substitui uma configuração do operador alterada intencionalmente.