Cette section fournit des instructions étape par étape pour installer l’interface web de Zabbix.
Suivez ces étapes après avoir installé le backend de Zabbix — serveur Zabbix, agent et base de données.

Le frontend de Zabbix est écrit en PHP ; un serveur web prenant en charge PHP est donc nécessaire pour l’exécuter.

Vous pouvez en savoir plus sur la configuration de SSL pour l’interface web Zabbix en consultant ces bonnes pratiques.

Écran de bienvenue

Ouvrez l’URL du frontend Zabbix dans le navigateur. Si vous avez installé Zabbix à partir de paquets, l’URL est :

pour Apache : http://<server_ip_or_name>/zabbix
pour Nginx : http://<server_ip_or_name>

Vous devriez voir le premier écran de l’assistant d’installation du frontend.

Utilisez le menu déroulant Default language pour modifier la langue par défaut du système et poursuivre le processus d’installation dans la langue sélectionnée (facultatif). Pour plus d’informations, consultez Installation de langues supplémentaires du frontend.

Notez que le fait de définir la langue sur English (en_US) activera également le format de date/heure américain dans le frontend.

Vérification des prérequis

Assurez-vous que tous les prérequis obligatoires du frontend Zabbix sont remplis.

Prérequis	Valeur minimale	Description
Version de PHP	8.2.0
Option PHP "memory_limit"	128MB	Dans php.ini : memory_limit = 128M
Option PHP "post_max_size"	16MB	Dans php.ini : post_max_size = 16M
Option PHP "upload_max_filesize"	2MB	Dans php.ini : upload_max_filesize = 2M
Option PHP "max_execution_time"	300 secondes	Dans php.ini : max_execution_time = 300 (les valeurs 0 et -1 sont également autorisées)
Option PHP "max_input_time"	300 secondes	Dans php.ini : max_input_time = 300 (les valeurs 0 et -1 sont également autorisées)
Prise en charge des bases de données PHP	Une des suivantes : MySQL, PostgreSQL	Voir Requirements pour la liste de toutes les extensions PHP obligatoires et facultatives. Notez que les prérequis facultatifs non satisfaits sont affichés avec un statut Warning rouge, et le processus d'installation peut se poursuivre même s'ils ne sont pas remplis.
PHP bcmath	doit être activé
PHP mbstring	doit être activé
Option PHP "mbstring.func_overload"	doit être désactivée	Dans php.ini : mbstring.func_overload = 0
Option PHP "session.auto_start"	doit être désactivée	Dans php.ini : session.auto_start = 0
Option PHP "arg_separator.output"	&	Dans php.ini : arg_separator.output = "&" (la valeur "&" est également autorisée)

Si l'utilisateur Apache ou le groupe d'utilisateurs doit être modifié, vérifiez les autorisations du dossier de session ; sinon, l'installation de Zabbix risque de ne pas pouvoir se poursuivre.

Configurer la connexion à la base de données

Saisissez les informations nécessaires pour vous connecter à la base de données. La base de données Zabbix doit déjà être créée.

Pour MySQL, saisir localhost ou laisser le champ Hôte de la base de données vide entraîne une connexion via le socket Unix par défaut. Le formulaire d’installation ne propose pas de champ distinct Socket de la base de données ; ainsi, pour utiliser un socket personnalisé, configurez-le dans les paramètres du serveur Zabbix (par exemple, avec DBSocket= dans zabbix_server.conf). Cela permet de maintenir l’interface web alignée sur les paramètres de connexion entre le serveur et la base de données.

Pour PostgreSQL, si le champ Hôte de la base de données est laissé vide, le socket de domaine Unix par défaut est utilisé. Si un chemin de socket est saisi (par exemple, /var/run/pgbouncer), ce socket de domaine Unix sera utilisé à la place.

Si l’option Chiffrement TLS de la base de données est cochée, des champs supplémentaires pour configurer la connexion TLS à la base de données apparaissent dans le formulaire (MySQL ou PostgreSQL uniquement).

Si Stocker les identifiants dans est défini sur HashiCorp Vault ou CyberArk Vault, des paramètres supplémentaires deviennent disponibles :

pour HashiCorp Vault : point de terminaison de l’API Vault, préfixe du coffre, chemin du secret et jeton d’authentification ;
pour CyberArk Vault : point de terminaison de l’API Vault, préfixe du coffre, chaîne de requête du secret et certificats. En cochant la case Certificats Vault, deux nouveaux champs permettant de spécifier les chemins vers le fichier de certificat SSL et le fichier de clé SSL apparaîtront.

Paramètres

La saisie d’un nom pour le serveur Zabbix est facultative ; toutefois, s’il est renseigné, il sera affiché dans la barre de menu et les titres des pages.

Définissez le fuseau horaire et le thème par défaut pour l’interface web.

Si l’option Encrypt connections from Web interface est cochée, des champs supplémentaires pour la configuration de la connexion TLS entre le serveur Zabbix et l’interface web apparaissent dans le formulaire.

Résumé de la préinstallation

Consultez un résumé des paramètres.

La sous-page affichera les données si une configuration TLS a été ajoutée.

Installation

Si vous installez Zabbix à partir des sources, téléchargez le fichier de configuration et placez-le dans conf/ dans le sous-répertoire des documents HTML du serveur web où vous avez copié les fichiers PHP de Zabbix.

Si l’utilisateur du serveur web dispose d’un accès en écriture au répertoire conf/, le fichier de configuration sera enregistré automatiquement et il sera possible de passer immédiatement à l’étape suivante.

Terminez l’installation.