Installation osTicket · 8 min read · Oct 20, 2025

Comment installer osTicket avec Nginx sur Debian 11

osTicket est un système de ticket de support gratuit et open-source utilisé pour évoluer et rationaliser votre service client et améliorer votre expérience client. Il offre une interface web pour gérer, organiser et suivre tous les tickets de support. Il est écrit en PHP et prend en charge diverses bases de données telles que MySQL et PostgreSQL.

Fonctionnalités

  • Rapports de tableau de bord
  • Sujet d’aide configurable
  • Accords de niveau de service
  • Filtres de tickets
  • Portail de support client
  • Répondeur automatique

Ce tutoriel vous montrera comment installer osTicket sur Debian 11.

Prérequis

  • Un serveur exécutant Debian 11.
  • Un nom de domaine valide pointé avec l’IP de votre serveur.
  • Un mot de passe root configuré sur le serveur.

Commencer

Tout d’abord, mettez à jour et améliorez tous les paquets système vers la dernière version en utilisant la commande suivante.

apt update -y  
apt upgrade -y

Une fois tous les paquets mis à jour, vous pouvez installer d’autres paquets requis avec la commande suivante :

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

Une fois tous les paquets requis installés, vous pouvez passer à l’étape suivante.

Installer Nginx et PHP

Tout d’abord, installez le paquet du serveur web Nginx en utilisant la commande suivante.

apt install nginx -y

Ensuite, ajoutez le dépôt PHP en utilisant la commande suivante.

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

Ensuite, installez la dernière version de PHP et d’autres dépendances PHP requises en utilisant la commande suivante.

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

Après l’installation, éditez le fichier de configuration PHP.

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

Changez la ligne suivante.

cgi.fix_pathinfo=0

Enregistrez et fermez le fichier, puis redémarrez le service PHP-FPM pour appliquer les modifications.

systemctl restart php8.1-fpm

Installer et configurer MariaDB

Tout d’abord, installez le serveur de base de données MariaDB en utilisant la commande suivante.

apt install mariadb-server -y

Ensuite, sécurisez l’installation de MariaDB avec la commande suivante.

mysql_secure_installation

Répondez à toutes les questions ci-dessous :

Set root password? [Y/n] Y
New password:
Re-enter new password:
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Ensuite, connectez-vous à l’interface de commande MariaDB en tant qu’utilisateur root.

mysql -u root -p

Ensuite, créez une base de données et un utilisateur pour osTicket.

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

Ensuite, videz les privilèges et quittez l’interface de commande MariaDB avec la commande suivante.

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

Installer osTicket

Tout d’abord, téléchargez la dernière version d’osTicket depuis la page de téléchargement GitHub.

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

Une fois le téléchargement terminé, créez un répertoire pour osTicket et extrayez le fichier téléchargé à l’intérieur de ce répertoire.

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

Ensuite, définissez la propriété et les permissions sur le répertoire osticket.

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

Ensuite, renommez le fichier de configuration d’exemple d’osTicket.

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

Une fois que vous avez terminé, vous pouvez passer à l’étape suivante.

Configurer Nginx pour osTicket

Ensuite, vous devrez créer un fichier de configuration d’hôte virtuel Nginx pour osTicket. Vous pouvez le créer avec la commande suivante.

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

Ajoutez la configuration suivante.

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;


# Activer 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;
}
}

Enregistrez et fermez le fichier, puis vérifiez la configuration de Nginx avec la commande suivante.

ginx -t

Vous obtiendrez la sortie suivante.

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Ensuite, redémarrez le service Nginx pour appliquer les modifications.

systemctl restart nginx

Vous pouvez également vérifier l’état de Nginx en utilisant la commande suivante.

systemctl status nginx

Vous devriez voir l’état de Nginx dans la sortie suivante.

? nginx.service - Un serveur web haute performance et un serveur proxy inverse
     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 Un serveur web haute performance et un serveur proxy inverse.
Dec 21 08:15:10 debian11 systemd[1]: Starting Un serveur web haute performance et un serveur proxy inverse...
Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Dec 21 08:15:10 debian11 systemd[1]: Started Un serveur web haute performance et un serveur proxy inverse.

À ce stade, Nginx est installé et configuré pour osTicket. Vous pouvez maintenant accéder à osTicket.

Accéder à l’interface web d’osTicket

Ouvrez votre navigateur web et accédez à la page d’installation d’osTicket en utilisant l’URL http://osticket.example.com. Vous devriez voir la page des prérequis.

Cliquez sur Continuer. Vous devriez voir la page d’installation de base.

Définissez l’URL de votre helpdesk, le nom, l’email, le nom de la base de données, le nom d’utilisateur, le mot de passe, puis cliquez sur le bouton Installer maintenant pour commencer l’installation. Une fois osTicket installé, vous devriez voir la page suivante.

Pour accéder au panneau de contrôle d’osTicket, tapez l’URL http://osticket.example.com/scp dans votre navigateur web. Vous devriez voir la page de connexion d’osTicket.

Fournissez votre nom d’utilisateur admin, votre mot de passe et cliquez sur le bouton Connexion. Vous devriez voir le tableau de bord d’osTicket à l’écran suivant.

Vous pouvez également accéder à la page du forum d’osTicket en utilisant l’URL https://forum.osticket.com.

Activer SSL sur osTicket

Pour installer le SSL Let’s Encrypt sur le site web d’osTicket, vous devrez installer le paquet certbot sur votre serveur.

Tout d’abord, installez le gestionnaire de paquets Snap avec la commande suivante :

apt install snapd

Ensuite, mettez à jour le paquet Snap vers la dernière version :

snap install core  
snap refresh core

Ensuite, installez le paquet certbot en utilisant la commande suivante :

snap install --classic certbot

Ensuite, créez un lien symbolique pour le binaire Certbot vers l’emplacement système :

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

Ensuite, exécutez la commande suivante pour télécharger et installer les certificats SSL Let’s Encrypt :

certbot --nginx -d osticket.example.com

On vous demandera de fournir votre adresse e-mail et d’accepter les conditions de service :

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.3-September-21-2022.pdf. You must
agree in order to register with the ACME server. Do you agree?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued, to
share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

Tapez Y et appuyez sur la touche Entrée pour télécharger et installer les certificats SSL pour votre domaine :

Account registered.
Requesting a certificate for osticket.example.com

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/osticket.example.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/osticket.example.com/privkey.pem
This certificate expires on 2023-03-22.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate
Successfully deployed certificate for osticket.example.com to /etc/nginx/conf.d/osticket.conf
Congratulations! You have successfully enabled HTTPS on https://osticket.example.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
If you like Certbot, please consider supporting our work by:
 * Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donating to EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Conclusion

Félicitations ! vous avez réussi à installer osTicket avec Nginx sur Debian 11. Vous pouvez maintenant mettre en œuvre osTicket dans votre entreprise et l’utiliser comme système de gestion de helpdesk. N’hésitez pas à me poser des questions si vous en avez.

Share: X/Twitter LinkedIn

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.