Como Instalar o osTicket no Servidor Ubuntu 24.04

osTicket é uma solução de help desk e ticketing de código aberto escrita em PHP. Ele suporta múltiplas integrações, como e-mail, número de telefone e formulários da web. Você também pode configurar campos personalizados, filtros, tópicos, tarefas e também respostas automáticas.

Neste guia, você aprenderá como instalar o sistema de ticketing de código aberto osTicket no servidor Ubuntu 24.04. Você estará instalando o osTicket com a pilha LAMP (Linux, Apache, MariaDB e PHP) e segurando o osTicket com HTTPS através do Certbot e Letsencrypt.

Pré-requisitos

Para completar este guia, certifique-se de ter o seguinte:

• Um servidor Ubuntu 24.04
• Um usuário não-root com privilégios de administrador
• Um nome de domínio apontado para o endereço IP do servidor

Instalando dependências

osTicket é um sistema de ticketing de código aberto escrito em PHP. Para instalar o osTicket no seu sistema Ubuntu, você deve instalar a pilha LAMP (Linux, Apache, MariaDB e PHP). Neste momento, você precisa do PHP 8.2, então você o instalará através de um repositório de terceiros.

Primeiro, execute o seguinte comando para instalar pacotes básicos no seu sistema Ubuntu e adicionar o repositório PPA para PHP. Neste caso, você usará o PHP 8.2 para instalar o osTicket, que está disponível no repositório PPA.

sudo apt install ca-certificates apt-transport-https software-properties-common lsb-release -y  
sudo add-apt-repository ppa:ondrej/php -y

Agora execute o comando abaixo para instalar as dependências da pilha LAMP no seu sistema Ubuntu. Digite ‘ Y ‘ para confirmar a instalação.

sudo apt install apache2 mariadb-server php8.2 libapache2-mod-php8.2 php8.2-mysql php8.2-cgi php8.2-fpm php8.2-cli php8.2-curl php8.2-gd php8.2-imap php8.2-mbstring php-pear php8.2-intl php8.2-apcu php8.2-common php8.2-bcmath php8.2-xml php8.2-zip

Após a instalação ser concluída, verifique o status do serviço ‘ apache2 ‘ usando o seguinte comando.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Você pode ver abaixo que o servidor web Apache está habilitado e em execução.

Em seguida, verifique o status do servidor MariaDB com o comando abaixo. Você verá que o servidor MariaDB também está em execução e habilitado no seu sistema Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por último, execute o comando abaixo para verificar a versão do PHP. Você verá que o PHP 8.2 está instalado no seu sistema através do repositório PPA.

sudo php -v  
sudo php -m

Configurando o PHP

Nesta seção, você configurará o PHP editando o arquivo padrão ‘php.ini’ e reiniciará o servidor web Apache.

Abra o arquivo ‘ /etc/php/8.2/apache2/php.ini ‘ usando o seguinte editor ‘ nano ‘.

sudo nano /etc/php/8.2/apache2/php.ini

Altere a configuração padrão com o seguinte. Certifique-se de ajustar as opções ‘ date.timezone ‘ e ‘ memory_limit ‘ conforme necessário.

date.timezone = Europe/Berlin  
memory_limit = 512M

Quando terminar, salve o arquivo e saia do editor.

Por último, execute o comando ‘ systemctl ‘ abaixo para reiniciar o servidor web Apache e aplicar suas novas configurações do PHP.

sudo systemctl restart apache2

Configurando o servidor MariaDB

Após configurar o PHP, você estará segurando a instalação do seu servidor MariaDB e criando um novo banco de dados e usuário para o osTicket. Você usará a ferramenta ‘mariadb-secure-installation’ para proteger o servidor MariaDB e, em seguida, usará o cliente ‘mariadb’.

Execute o seguinte ‘ mariadb-secure-installation ‘ para proteger a instalação do seu servidor MariaDB.

sudo mariadb-secure-installation

Agora você será questionado sobre as seguintes configurações:

• Para a instalação padrão do servidor MariaDB sem uma senha de root, pressione ENTER quando solicitado sobre a senha.
• A autenticação local para usuários root do MariaDB é protegida por padrão, insira ‘n’ quando solicitado a mudar o método de autenticação para ‘ unix_socket ‘.
• Insira ‘Y’ para criar uma nova senha de root do MariaDB. Em seguida, insira a senha forte para seu usuário root do MariaDB e repita.
• Quando solicitado a desabilitar a autenticação remota para o usuário root do MariaDB, insira ‘ Y ‘ para concordar.
• A instalação padrão do servidor MariaDB vem com o banco de dados ‘test’ e permite que um usuário anônimo acesse. Insira ‘ Y ‘ para ambas as configurações para remover o banco de dados padrão ‘test’ e remover o privilégio anônimo.
• Por último, insira ‘ Y ‘ para confirmar o recarregamento dos privilégios da tabela.

Após o servidor MariaDB ser configurado e protegido, você precisa criar um novo banco de dados e usuário para a instalação do osTicket.

Faça login no servidor MariaDB usando o comando do cliente ‘mariadb’ abaixo. Digite sua senha de root do MariaDB quando solicitado.

sudo mariadb -u root -p

Uma vez logado, execute as seguintes consultas para criar um novo banco de dados e usuário ‘ osticket ‘ com a senha ‘osticketpassword’. Altere os seguintes detalhes conforme necessário.

CREATE DATABASE osticket;  
CREATE USER 'osticket'@'localhost' IDENTIFIED BY 'osticketpassword';  
GRANT ALL PRIVILEGES ON osticket.* TO osticket@localhost IDENTIFIED BY "osticketpassword";  
FLUSH PRIVILEGES;

Agora execute a consulta abaixo para garantir que o usuário ‘ osticket ‘ possa acessar o banco de dados ‘osticket’.

SHOW GRANTS FOR osticket@localhost;

Na saída a seguir, você pode ver que o ‘osticket’ banco de dados é acessível através do usuário ‘ osticket ‘.

Por último, digite ‘ quit ‘ para sair do servidor MariaDB.

Baixando o osTicket

Agora que você configurou o PHP e o servidor MariaDB, você estará baixando o código-fonte do osTicket e configurando o diretório de instalação.

Vá para o diretório ‘ /var/www/ ‘ e baixe o código-fonte do osTicket usando o comando ‘ wget ‘ abaixo.

cd /var/www  
wget https://github.com/osTicket/osTicket/releases/download/v1.18.1/osTicket-v1.18.1.zip

Uma vez baixado, execute o comando ‘unzip’ abaixo para extrair o código-fonte do osTicket para o diretório ‘ osTicket ‘. Assim, o diretório de instalação do osTicket estará disponível em ‘ /var/www/osTicket ‘.

unzip osTicket-v1.18.1.zip -d osTicket

Agora execute o comando abaixo para mudar a propriedade do diretório ‘ /var/www/osTicket ‘ para o usuário ‘ www-data ‘ e mudar a permissão padrão para ‘ 0755 ‘.

sudo chown -R www-data:www-data /var/www/osTicket  
sudo chmod 755 /var/www/osTicket

Por último, execute o seguinte comando para copiar a configuração do osTicket para ‘ /var/www/osTicket/upload/include/ost-config.php ‘.

mv /var/www/osTicket/upload/include/ost-sampleconfig.php /var/www/osTicket/upload/include/ost-config.php

Configurando o host virtual do Apache

Nesta seção, você estará criando um novo arquivo de host virtual do Apache para o osTicket. Portanto, certifique-se de que seu nome de domínio esteja apontado para um endereço IP do servidor.

Crie um novo arquivo de host virtual do Apache ‘ /etc/apache2/sites-available/osticket.conf ‘ com o seguinte editor ‘ nano ‘.

sudo nano /etc/apache2/sites-available/osticket.conf

Insira a seguinte configuração e certifique-se de alterar a opção ‘ ServerName ‘ com seu nome de domínio.

  
ServerName ticket.howtoforge.local  
ServerAdmin admin@localhost  
DocumentRoot /var/www/osTicket/upload  
  
  
Require all granted  
Options FollowSymlinks  
AllowOverride All  
  
  
ErrorLog ${APACHE_LOG_DIR}/osticket.error.log  
CustomLog ${APACHE_LOG_DIR}/osticket.access.log combined  

Quando terminar, salve o arquivo e saia do editor.

Agora execute o comando abaixo para ativar o arquivo ‘ osticket.conf ‘ e verificar sua sintaxe do Apache. Se você tiver a sintaxe do Apache correta, verá uma saída ‘ Syntax is OK ‘.

sudo a2ensite osticket.conf  
sudo apachectl configtest

Por último, execute o comando ‘ systemctl ‘ abaixo para reiniciar o servidor web Apache e aplicar suas alterações.

sudo systemctl restart apache2

Protegendo o osTicket com HTTPS

Nesta seção, você estará protegendo a instalação do osTicket com HTTPS. Para isso, você estará instalando e usando o Certbot para gerar certificados SSL/TLS do letsencrypt.

Instale o ‘certbot’ e o plugin ‘python3-certbot-apache’ com o seguinte comando ‘apt’.

sudo apt install certbot python3-certbot-apache -y

Após a instalação ser concluída, execute o comando ‘certbot’ abaixo para gerar certificados SSL/TLS e proteger o osTicket com HTTPS. Certifique-se de alterar o seguinte endereço de e-mail e nome de domínio com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d ticket.howtoforge.local

Quando terminar, seus certificados SSL/TLS estarão disponíveis no diretório ‘/etc/letsencrypt/live/domain.com’ e sua instalação do osTicket deve estar protegida com HTTPS.

Instalando o osTicket

Abra seu navegador da web e visite seu nome de domínio, como https://tiket.howtoforge.local. Se tudo correr bem, você verá o assistente de instalação do osTicket.

Certifique-se de que todas as dependências para o osTicket estejam instaladas e clique em Continuar.

Altere as configurações básicas do sistema, como seu nome de domínio, em seguida, insira o novo usuário administrador para o osTicket e insira os detalhes do banco de dados que você criou.

Se a instalação estiver completa, você verá a seguinte página:

Em seguida, volte ao terminal do seu servidor e execute o comando abaixo para excluir o diretório ‘setup’ da sua instalação do osTicket.

sudo rm -rf /var/www/osTicket/upload/setup

Agora, se você acessar a página inicial do osTicket, verá a página padrão assim:

Faça login no osTicket com seu usuário e senha de administrador.

Se você tiver as credenciais de administrador corretas, verá o seguinte Painel de Administração do osTicket.

Conclusão

Parabéns! Você completou a instalação do osTicket no servidor Ubuntu 24.04. Você tem o osTicket em funcionamento com a pilha LAMP (Linux, Apache, MariaDB e PHP), e você também protegeu o osTicket com HTTPS através do Certbot e do letsencrypt.