6 Web interface installation

This section provides step-by-step instructions for installing Zabbix web interface. Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed.

Welcome screen

Open Zabbix frontend URL in the browser. If you have installed Zabbix from packages, the URL is:

You should see the first screen of the frontend installation wizard.

Use the Default language drop-down menu to change system default language and continue the installation process in the selected language (optional). For more information, see Installation of additional frontend languages.

6 Web interface installation - 图1

Check of pre-requisites

Make sure that all software prerequisites are met.

6 Web interface installation - 图2

Pre-requisiteMinimum valueDescription
PHP version7.2.5
PHP memory_limit option128MBIn php.ini:
memory_limit = 128M
PHP post_max_size option16MBIn php.ini:
post_max_size = 16M
PHP upload_max_filesize option2MBIn php.ini:
upload_max_filesize = 2M
PHP max_execution_time option300 seconds (values 0 and -1 are allowed)In php.ini:
max_execution_time = 300
PHP max_input_time option300 seconds (values 0 and -1 are allowed)In php.ini:
max_input_time = 300
PHP session.auto_start optionmust be disabledIn php.ini:
session.auto_start = 0
Database supportOne of: MySQL, Oracle, PostgreSQL.One of the following modules must be installed:
mysql, oci8, pgsql
bcmathphp-bcmath
mbstringphp-mbstring
PHP mbstring.func_overload optionmust be disabledIn php.ini:
mbstring.func_overload = 0
socketsphp-net-socket. Required for user script support.
gd2.0.28php-gd. PHP GD extension must support PNG images (—with-png-dir), JPEG (—with-jpeg-dir) images and FreeType 2 (—with-freetype-dir).
libxml2.6.15php-xml
xmlwriterphp-xmlwriter
xmlreaderphp-xmlreader
ctypephp-ctype
sessionphp-session
gettextphp-gettext
Since Zabbix 2.2.1, the PHP gettext extension is not a mandatory requirement for installing Zabbix. If gettext is not installed, the frontend will work as usual, however, the translations will not be available.

Optional pre-requisites may also be present in the list. A failed optional prerequisite is displayed in orange and has a Warning status. With a failed optional pre-requisite, the setup may continue.

If there is a need to change the Apache user or user group, permissions to the session folder must be verified. Otherwise Zabbix setup may be unable to continue.

Configure DB connection

Enter details for connecting to the database. Zabbix database must already be created.

6 Web interface installation - 图3

If the Database TLS encryption option is checked, then additional fields for configuring the TLS connection to the database appear in the form (MySQL or PostgreSQL only).

If HashiCorp Vault option is selected for storing credentials, additional fields are available for specifying the Vault API endpoint, secret path and authentication token:

6 Web interface installation - 图4

Settings

Entering a name for Zabbix server is optional, however, if submitted, it will be displayed in the menu bar and page titles.

Set the default time zone and theme for the frontend.

6 Web interface installation - 图5

Pre-installation summary

Review a summary of settings.

6 Web interface installation - 图6

Install

If installing Zabbix from sources, download the configuration file and place it under conf/ in the webserver HTML documents subdirectory where you copied Zabbix PHP files to.

6 Web interface installation - 图7

6 Web interface installation - 图8

Providing the webserver user has write access to conf/ directory the configuration file would be saved automatically and it would be possible to proceed to the next step right away.

Finish the installation.

6 Web interface installation - 图9

Log in

Zabbix frontend is ready! The default user name is Admin, password zabbix.

6 Web interface installation - 图10

Proceed to getting started with Zabbix.