Instalação osTicket · 8 min read · Oct 20, 2025

Como Instalar osTicket com Nginx no Debian 11

osTicket é um sistema de tickets de suporte gratuito e de código aberto usado para escalar e otimizar seu atendimento ao cliente e melhorar sua experiência do cliente. Ele oferece uma interface baseada na web para gerenciar, organizar e rastrear todos os tickets de suporte. É escrito em PHP e suporta vários bancos de dados, como MySQL e PostgreSQL.

Recursos

  • Relatórios do Painel
  • Tópico de Ajuda Configurável
  • Acordos de Nível de Serviço
  • Filtros de Tickets
  • Portal de Suporte ao Cliente
  • Resposta Automática

Este tutorial mostrará como instalar o osTicket no Debian 11.

Pré-requisitos

  • Um servidor rodando Debian 11.
  • Um nome de domínio válido apontado para o IP do seu servidor.
  • Uma senha de root configurada no servidor.

Começando

Primeiro, atualize e faça upgrade de todos os pacotes do sistema para a versão mais recente usando o seguinte comando.

apt update -y  
apt upgrade -y

Uma vez que todos os pacotes estejam atualizados, você pode instalar outros pacotes necessários com o seguinte comando:

apt install ca-certificates apt-transport-https software-properties-common wget curl

Uma vez que todos os pacotes necessários estejam instalados, você pode prosseguir para a próxima etapa.

Instalar Nginx e PHP

Primeiro, instale o pacote do servidor web Nginx usando o seguinte comando.

apt install nginx -y

Em seguida, adicione o repositório PHP usando o seguinte comando.

curl -sSL https://packages.sury.org/php/README.txt | bash -x

Em seguida, instale a versão mais recente do PHP e outras dependências necessárias do PHP usando o seguinte comando.

apt install php8.1 php8.1-mysql php8.1-cgi php8.1-fpm php8.1-cli php8.1-curl php8.1-gd php8.1-imap php8.1-mbstring php8.1-intl php8.1-apcu php8.1-common php8.1-gettext php8.1-bcmath php8.1-xml php8.1-dom -y

Após a instalação, edite o arquivo de configuração do PHP.

nano /etc/php/8.1/fpm/php.ini

Altere a seguinte linha.

cgi.fix_pathinfo=0

Salve e feche o arquivo, então reinicie o serviço PHP-FPM para aplicar as mudanças.

systemctl restart php8.1-fpm

Instalar e Configurar MariaDB

Primeiro, instale o servidor de banco de dados MariaDB usando o seguinte comando.

apt install mariadb-server -y

Em seguida, proteja a instalação do MariaDB com o seguinte comando.

mysql_secure_installation

Responda a todas as perguntas abaixo:

Definir senha root? [Y/n] Y
Nova senha:
Re-enter nova senha:
Remover usuários anônimos? [Y/n] Y
Desabilitar login root remotamente? [Y/n] Y
Remover banco de dados de teste e acesso a ele? [Y/n] Y
Recarregar tabelas de privilégios agora? [Y/n] Y

Em seguida, faça login no shell do MariaDB como usuário root.

mysql -u root -p

Em seguida, crie um banco de dados e um usuário para o osTicket.

MariaDB [(none)]> create database osticketdb;  
MariaDB [(none)]> grant all privileges on osticketdb.* to osticketuser identified by 'secure-password';

Em seguida, limpe os privilégios e saia do shell do MariaDB com o seguinte comando.

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

Instalar osTicket

Primeiro, baixe a versão mais recente do osTicket da página de download do GitHub.

wget https://github.com/osTicket/osTicket/releases/download/v1.17.2/osTicket-v1.17.2.zip

Uma vez que o download esteja completo, crie um diretório para o osTicket e extraia o arquivo baixado dentro desse diretório.

mkdir /var/www/html/osticket  
unzip osTicket-v1.17.2.zip -d /var/www/html/osticket

Em seguida, defina a propriedade e as permissões no diretório osticket.

chown -R www-data:www-data /var/www/html/osticket  
chmod -R 755 /var/www/html/osticket

Em seguida, renomeie o arquivo de configuração de amostra do osTicket.

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

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Configurar Nginx para osTicket

Em seguida, você precisará criar um arquivo de configuração de host virtual do Nginx para o osTicket. Você pode criá-lo com o seguinte comando.

nano /etc/nginx/conf.d/osticket.conf

Adicione a seguinte configuração.

server {
listen 80;
server_name osticket.example.com;
root /var/www/html/osticket/upload;
index index.php index.html index.htm;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;


# Habilitar gzip
gzip on;
gzip_min_length 1000;
gzip_types text/plain application/x-javascript text/xml text/css application/xml;

set $path_info "";

location ~ /include {
deny all;
return 403;
}

if ($request_uri ~ "^/api(/[^"]+)") {
set $path_info $1;
}

location ~ ^/api/(?:tickets|tasks).*$ {
try_files $uri $uri/ /api/http.php?$query_string;
}

if ($request_uri ~ "^/scp/.*\.php(/[^"]+)") {
set $path_info $1;
}

location ~ ^/scp/ajax.php/.*$ {
try_files $uri $uri/ /scp/ajax.php?$query_string;
}

location / {
try_files $uri $uri/ index.php;
}

location ~ \.php$ {
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}
}

Salve e feche o arquivo, então verifique a configuração do Nginx com o seguinte comando.

ginx -t

Você receberá a seguinte saída.

nginx: o arquivo de configuração /etc/nginx/nginx.conf tem sintaxe ok
nginx: o teste do arquivo de configuração /etc/nginx/nginx.conf foi bem-sucedido

Em seguida, reinicie o serviço Nginx para aplicar as mudanças.

systemctl restart nginx

Você também pode verificar o status do Nginx usando o seguinte comando.

systemctl status nginx

Você deve ver o status do Nginx na seguinte saída.

? nginx.service - Um servidor web de alto desempenho e um servidor proxy reverso
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2022-12-21 08:15:10 UTC; 4s ago
       Docs: man:nginx(8)
    Process: 24700 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 24701 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 24702 (nginx)
      Tasks: 2 (limit: 2339)
     Memory: 3.1M
        CPU: 25ms
     CGroup: /system.slice/nginx.service
             ??24702 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??24703 nginx: worker process

Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Succeeded.
Dec 21 08:15:10 debian11 systemd[1]: Stopped Um servidor web de alto desempenho e um servidor proxy reverso.
Dec 21 08:15:10 debian11 systemd[1]: Iniciando Um servidor web de alto desempenho e um servidor proxy reverso...
Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Falhou ao analisar PID do arquivo /run/nginx.pid: Argumento inválido
Dec 21 08:15:10 debian11 systemd[1]: Iniciado Um servidor web de alto desempenho e um servidor proxy reverso.

Neste ponto, o Nginx está instalado e configurado para o osTicket. Você pode agora prosseguir para acessar o osTicket.

Acessar a Interface Web do osTicket

Abra seu navegador e acesse a página de instalação do osTicket usando a URL http://osticket.example.com. Você deve ver a página de pré-requisitos.

Clique em Continuar. Você deve ver a página de instalação básica.

Defina sua URL de helpdesk, nome, e-mail, nome do banco de dados, nome de usuário, senha e clique no botão Instalar Agora para iniciar a instalação. Uma vez que o osTicket esteja instalado, você deve ver a seguinte página.

Para acessar o painel de controle do osTicket, digite a URL http://osticket.example.com/scp em seu navegador. Você deve ver a página de login do osTicket.

Forneça seu nome de usuário admin, senha e clique no botão Login. Você deve ver o painel do osTicket na tela seguinte.

Você também pode acessar a página do fórum do osTicket usando a URL https://forum.osticket.com.

Habilitar SSL no osTicket

Para instalar o SSL Let’s Encrypt no site do osTicket, você precisará instalar o pacote certbot em seu servidor.

Primeiro, instale o gerenciador de pacotes Snap com o seguinte comando:

apt install snapd

Em seguida, atualize o pacote Snap para a versão mais recente:

snap install core  
snap refresh core

Em seguida, instale o pacote certbot usando o seguinte comando:

snap install --classic certbot

Em seguida, crie um link simbólico para o binário do Certbot na localização do sistema:

ln -s /snap/bin/certbot /usr/bin/certbot

Em seguida, execute o seguinte comando para baixar e instalar os certificados SSL Let’s Encrypt:

certbot --nginx -d osticket.example.com

Você será solicitado a fornecer seu endereço de e-mail e aceitar os termos de serviço:

Salvando log de depuração em /var/log/letsencrypt/letsencrypt.log
Digite o endereço de e-mail (usado para renovações urgentes e avisos de segurança)
 (Digite 'c' para cancelar): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Por favor, leia os Termos de Serviço em
https://letsencrypt.org/documents/LE-SA-v1.3-September-21-2022.pdf. Você deve
concordar para se registrar no servidor ACME. Você concorda?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(S)im/(N)ão: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Você estaria disposto, uma vez que seu primeiro certificado seja emitido com sucesso,
a compartilhar seu endereço de e-mail com a Electronic Frontier Foundation, um parceiro fundador do projeto Let's Encrypt e a organização sem fins lucrativos que
desenvolve o Certbot? Gostaríamos de enviar e-mail sobre nosso trabalho de criptografia na web,
notícias da EFF, campanhas e maneiras de apoiar a liberdade digital.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(S)im/(N)ão: Y

Digite Y e pressione a tecla Enter para baixar e instalar os certificados SSL para seu domínio:

Conta registrada.
Solicitando um certificado para osticket.example.com

Certificado recebido com sucesso.
Certificado salvo em: /etc/letsencrypt/live/osticket.example.com/fullchain.pem
Chave salva em:         /etc/letsencrypt/live/osticket.example.com/privkey.pem
Este certificado expira em 2023-03-22.
Esses arquivos serão atualizados quando o certificado for renovado.
Certbot configurou uma tarefa agendada para renovar automaticamente este certificado em segundo plano.

Implantando certificado
Certificado implantado com sucesso para osticket.example.com em /etc/nginx/conf.d/osticket.conf
Parabéns! Você habilitou com sucesso HTTPS em https://osticket.example.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Se você gosta do Certbot, considere apoiar nosso trabalho:
 * Doando para ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Doando para EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Conclusão

Parabéns! você instalou com sucesso o osTicket com Nginx no Debian 11. Você pode agora implementar o osTicket em sua empresa e usá-lo como um sistema de gerenciamento de helpdesk. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn
#Instalação osTicket

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.