How to Install Zabbix Monitoring Tool on Debian 11/10

Zabbix is a free, open-source, popular, and feature-rich IT infrastructure monitoring software developed using PHP language. It is used to monitor networks, servers, applications, services as well as cloud resources. It also supports the monitoring of storage devices, databases, virtual machines, telephony, IT security resources, and much more.

[ You might also like: How to Install Zabbix on RHEL 8 ]

For developers, Zabbix ships with an API that provides access to almost all functions available in Zabbix. It supports easy two-way integration with any software. You can also use the API to integrate Zabbix functions into third-party software.

Requirements

This tutorial shows how to install and configure the latest release of Zabbix open-source monitoring tool on Debian 11 and Debian 10 with MySQL database to keep data, PHP, and Apache Web Server as the main web interface.

Step 1: Installing Apache Web Server and PHP Packages

1. To install Zabbix, first, you need to install Apache and PHP along with some required PHP modules as follows.

# apt install apache2 php php-mysql php-mysqlnd php-ldap php-bcmath php-mbstring php-gd php-pdo php-xml libapache2-mod-php

2. In the installation process, the installer triggers the systemd to automatically start Apache service, and it also enables it to automatically start at system boot. You can check if it is up and running using the systemctl command.

# systemctl status apache2

The following are some useful systemctl commands for managing the Apache services under systemd.

# systemctl start apache2
# systemctl stop apache2
# systemctl restart apache2

Step 2: Install MariaDB Server and Client

3. To store data, Zabbix requires a database management system. It supports MySQL by default but for this guide, we will install MariaDB as a drop-in replacement for MySQL.

# apt install mariadb-server mariadb-client

4. When the installation is complete, the MariaDB service is auto-started and enabled to automatically start at system startup. To check if it is up and running, use the following command.

# systemctl status mariadb

5. Next, you need to secure your MariaDB server database installation. The installed package ships with a script that you need to run and follow the security recommendations.

# mysql_secure_installation

It will ask you to determine actions to remove anonymous users, disable root login remotely, remove test database and access to it, and apply all changes.

6. Once the database server is secured, you need to create a database for Zabbix. First, log in to the database to gain access to the MariaDB shell as follows.

# mysql -u root -p

7. Then issues the following SQL commands to create the required database (do not forget to set a secure password).

MariaDB [(none)]> create database zabbix character set utf8 collate utf8_bin;
MariaDB [(none)]> grant all privileges on zabbix.* to zabbix@localhost identified by 'admin@monit1';
MariaDB [(none)]> quit;

Step 3: Installing and Configuring Zabbix Server

8. To install Zabbix, you need to enable the Zabbix Official Repository which contains the Zabbix packages, as follows.

# wget --no-check-certificate https://repo.zabbix.com/zabbix/5.4/debian/pool/main/z/zabbix-release/zabbix-release_5.4-1+debian11_all.deb
# dpkg -i zabbix-release_5.4-1+debian11_all.deb
# apt update

9. Now install the Zabbix server, web frontend, agent packages using the following command.

# apt install zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-sql-scripts zabbix-agent

10. If the package installation is successful, next, import the initial schema and data into the Zabbix database which you created in the previous step.

# zcat /usr/share/doc/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix

11. Next, configure the Zabbix server daemon to use the database you created for it by editing the file /etc/zabbix/zabbix_server.conf.

# vim /etc/zabbix/zabbix_server.conf

Look for the following configuration options and update their values to reflect your database settings. Note that you need to uncomment any option(s) that are commented out and set their correct values.

DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=admin@monit1

Then save the new changes in the file and exit it.

12. You should also set up PHP to work correctly with the Zabbix frontend by defining your timezone in the /etc/zabbix/apache.conf file.

# vim /etc/zabbix/apache.conf

Find the configuration section for your PHP version, for example, PHP 7.x. Then uncomment the following line (by removing the “#” character at the start) to enable timezone for your server as shown in the screenshot.

php_value date.timezone Africa/Kampala

Save the changes and close the file.

13. Now restart the Apache server to apply recent changes.

# systemctl restart apache2

14. With all the perfect environment setup, you can now start the Zabbix server and agent processes, enabling them to auto-start at system boot as shown.

# systemctl start zabbix-server zabbix-agent
# systemctl enable zabbix-server zabbix-agent

15. Then make sure to check the status of the Zabbix server using the following command.

# systemctl status zabbix-server

16. Also, ensure that the Zabbix agent process is up and running by checking its status as shown. Remember the agent you have started is running on and monitoring the local host. If you want to monitor remote servers, install and configure agents on them (refer to related articles at the end of the guide).

# systemctl status zabbix-agent

17. Before you can access the Zabbix web frontend as shown in the next section if you have the UFW firewall service running, you need to open port 80(HTTP) and 443(HTTPS) to allow traffic to the Apache server.

# ufw allow 80/tcp
# ufw allow 443/tcp
# ufw reload

Step 4: Installing and Configuring Zabbix Web Frontend Interface

18. Before you can start using the Zabbix web frontend for monitoring, you need to configure and set it up via a web installer. To access the installer, open a web browser and point it to the following URL.

http://SERVER_FQDM/zabbix
OR
http://SERVER_IP/zabbix

19. Once you click go, or press Enter, you will land on the Welcome page as shown in the following screenshot. Click Next step to start the setup process.

20. The installer will then check the pre-requisites as shown in the screenshot, if all required PHP modules and configuration options are OK (scroll down to view more requirements), click Next step to proceed.

21. Next, enter the database connection settings for the Zabbix frontend to link to the database. Choose the database type (which should be MySQL), provide the database host, database port, database name, and database user, and the user’s password as shown in the screenshot.

22. Next, enter the Zabbix server details (hostname or host IP address and port number of the hosting server). Optionally, set a name for the installation.

23. Now the installer should show you the pre-installation summary page. If all is fine, click Next step to complete the setup.

24. Now click Finish, and you should be re-directed to the login page as shown in the next screenshot.

25. To login, enter the username Admin and password zabbix.

26. Once you have logged on, you will see the Monitoring section Dashboard. The Global view will display a sample of System information, problems by severity, problems, local time, and more, as shown in the screenshot.

27. As an important step, you need to change the default administrator account password. To do that, go to Administration ==> Users.

From the list of users, under Alias, click on Admin to open the user’s details. In the user details page, look for the Password field and click Change password. Then set a secure password and confirm it. And click Update to save the password.

You might also like to read the following related Zabbix articles.

That’s all! In this article, we’ve learned how to the latest version of Zabbix monitoring software on your Debian 11/10 server. You can find more information in the Zabbix documentation.

16 Comments

panos

December 17, 2021 at 12:53 am

Hello,

Can’t install zabbix-apache-conf and zabbix-sql-scripts.

What am I doing wrong?

Thank you
Panos
Samuel Melton

June 23, 2021 at 2:01 am

Can you explain step 7: “(do not forget to set a secure password).”?

Am I supposed to set a secure password for the database or for a “zabbix@localhost” user? I’m not at all familiar with this CLI so I’m not sure what’s happening here.

What’s the syntax for setting this password?

Thanks
- Ravi Saive
  
  June 23, 2021 at 11:55 am
  @Samuel,
  
  Replace the admin@monit1 with your own secure password this is what I mean in step 7.
```
MariaDB [(none)]> grant all privileges on zabbix.* to zabbix@localhost identified by 'admin@monit1';
```
student

May 5, 2021 at 2:57 am

Hi, thank you a lot for sharing this…

I have one problem I’m trying to start Zabbix-server it’s not starting i did all the steps and when it comes to starting the Zabbix server it’s not working any suggestions?

Please thank you in advance…
- Ravi Saive
  
  May 5, 2021 at 10:16 am
  
  @Student,
  
  Could you share what error you getting while starting the Zabbix server?
  - student
    
    May 5, 2021 at 3:38 pm
    
    Hi, I don’t get any error it just doesn’t start, the problem is only in starting the server ( apache2 and zabbix-agent they are active ).
clement

October 27, 2020 at 9:37 pm

Thanks a lot. On step 15 you should replace “start” by “status” in the command line.
- Ravi Saive
  
  October 28, 2020 at 11:00 am
  
  @Clement,
  
  Thanks for updating us, I have corrected the command as suggested…
M Innes

May 20, 2020 at 3:52 pm
There is a bug in the MariaDB on Debian 10 which means the database import does not work;

ERROR 1118 (42000) at line 1278: Row size too large (> 8126). Changing some columns to TEXT or BLOB may help. In the current row format, the BLOB prefix of 0 bytes is stored inline.

After some research i found this worked in my.cnf
```
innodb_strict_mode = 0
innodb_log_buffer_size = 32M 
```
Remove innodb_strict_mode = 0 after import.

If import already failed you will need to drop and recreate DB
- Aaron Kili
  
  May 21, 2020 at 12:12 pm
  
  @M
  
  Many thanks for sharing this.
- Daniel
  
  July 28, 2020 at 4:36 pm
  
  Thank you so much!
marc

April 25, 2020 at 12:35 am
```
# zcat /usr/share/doc/zabbix-server-mysql/create.sql.gz | mysql -u zabbix -p zabbix
```
ERROR 1045 (28000): Access denied for user ‘zabbix’@’localhost’ (using password: YES)
- Aaron Kili
  
  April 27, 2020 at 12:06 pm
  
  @marc
  
  Try to use the password you created for the zabbix database user in step 7, instead of zabbix.
- Eder Pardeiro
  
  January 18, 2021 at 6:59 am
  
  Same error here…
  
  ERROR 1045 (28000): Access denied for user ‘zabbix’@’localhost’ (using password: YES)
  
  I’m using the same password in step 7, but not work…
  - Eder Pardeiro
    
    January 18, 2021 at 7:15 am
    
    Now it’s work, but the error below appears:
    - Eder Pardeiro
      
      January 18, 2021 at 7:15 am
      
      ERROR 1118 (42000) at line 1284: Row size too large (> 8126). Changing some columns to TEXT or BLOB may help. In the current row format, the BLOB prefix of 0 bytes is stored inline.