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
Check Apache Status in Debian
Check Apache Status in Debian

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
Checkk MariaDB Status in Debian
Checkk MariaDB Status in Debian

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.

Secure MariaDB in Debian 10
Secure MariaDB in Debian 10

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
Configure Zabbix Database Settings
Configure Zabbix Database Settings

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
Configure PHP Timezone
Configure PHP Timezone

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
Start Zabbix Server and Agent
Start Zabbix Server and Agent

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

# systemctl status zabbix-server
Check Zabbix Status
Check Zabbix Status

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
Check Zabbix Agent Status
Check Zabbix Agent Status

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.

Zabbix Web Installer
Zabbix Web Installer

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.

Zabbix Checks Pre-requisites
Zabbix Checks Pre-requisites

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.

Zabbix Database Settings
Zabbix Database Settings

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.

Zabbix- Server Details
Zabbix- Server Details

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

Zabbix Pre-installation Summary
Zabbix Pre-installation Summary

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

Zabbix Installation Complete
Zabbix Installation Complete

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

Zabbix Login
Zabbix Login

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.

Zabbix Dashboard
Zabbix Dashboard

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.

Change Zabbix Admin Password
Change Zabbix Admin 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.

Aaron Kili
Aaron Kili is a Linux and F.O.S.S enthusiast, an upcoming Linux SysAdmin, web developer, and currently a content creator for TecMint who loves working with computers and strongly believes in sharing knowledge.

Each tutorial at TecMint is created by a team of experienced Linux system administrators so that it meets our high-quality standards.

Join the TecMint Weekly Newsletter (More Than 156,129 Linux Enthusiasts Have Subscribed)
Was this article helpful? Please add a comment or buy me a coffee to show your appreciation.

16 thoughts on “How to Install Zabbix Monitoring Tool on Debian 11/10”

  1. 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

    Reply
    • @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';
      
      Reply
  2. 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…

    Reply
      • 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 ).

        Reply
  3. 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

    Reply
  4. # 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)

    Reply
    • 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…

      Reply

Leave a Reply to Aaron Kili Cancel reply

Thank you for taking the time to share your thoughts with us. We appreciate your decision to leave a comment and value your contribution to the discussion. It's important to note that we moderate all comments in accordance with our comment policy to ensure a respectful and constructive conversation.

Rest assured that your email address will remain private and will not be published or shared with anyone. We prioritize the privacy and security of our users.