21 November, 2022 by Ashley

How to Install and Setup Zabbix on Ubuntu 20.04

Install and Setup Zabbix on Ubuntu 20.04 allows you to monitor and track the status of whatever you consider such as applications, servers, systems, CPU usage, hardware, RAM and disk space consumption, and network devices. Zabbix is an open-source monitoring tool, written in Java and C, with the frontend interface written in PHP. To monitor the network health and integrity of your servers quickly from anywhere, Zabbix is a solid suggestion.

This article will teach you how to Install and Setup Zabbix on Ubuntu 20.04. In the end, you will be able to run Zabbix on your Ubuntu and reduce your customer’s complaints since your monitoring tool will start to detect problems with hardware or software components.

Table of Contents

Prerequisites to Install Zabbix on Ubuntu 20.04

To let this installation work correctly, consider the below prerequisites and then move on to learn to Install and Setup Zabbix on Ubuntu 20.04 in the following of this article.

A system running Ubuntu 20.04.
TLS/SSL certificate installed (Optional but recommended)
A non-root user with sudo privileges and firewall configured with ufw.
A server with Apache httpd, MySQL/MariaDB database, Zabbix, and PHP version 7.2+ or > installed.

Note: PHP and httpd must be installed on the Zabbix server, but MySQL/MariaDB can be a remote server.

Tutorial Install and Setup Zabbix on Ubuntu 20.04

Installing Zabbix on your server guarantees the health of your IT infrastructure to clarify potential problems. Also, Zabbix enables information to be stored in a database to let you analyze data over time. In this way, the quality of provided services would be improved, and upgrading your equipment can be planned. Zabbix employs a variety of methods for gathering metrics, including client-server architecture and agentless monitoring of user services. It employs a small agent on the monitored client to acquire data and send it to the Zabbix server to collect server metrics. Your data is protected as it is transferred over insecure networks thanks to Zabbix’s support for encrypted communication between the server and connected clients.

Stay with us to go through this guide and review all the required steps to install and set up Zabbix on your Ubuntu server if you have provided all mentioned prerequisites. Install and Setup Zabbix on Ubuntu 20.04 helps you to monitor remote servers securely.

Step 1

Once you log in to your machine as your non-root server, run the following command to install the Zabbix server.

ssh opera@zabbix_server_ip_address

While the available Zabbix in the package manager of Ubuntu is outdated, you need to install the latest stable version which exists on the Official Zabbix repository. To download and install the repository configuration package, run:

wget https://repo.zabbix.com/zabbix/5.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_5.0-1+focal_all.deb
sudo dpkg -i zabbix-release_5.0-1+focal_all.deb

Now, you need to update the package index and install Zabbix server packages.

sudo apt update
sudo apt install zabbix-server-mysql zabbix-frontend-php
sudo apt install zabbix-agent

In this way, the Zabbix server and web frontend with MySQL database support will be installed. And the installing Zabbix agent helps you to collect data about the Zabbix server status.

Step 2

To start using Zabbix, you need to set up a database to hold the data that the Zabbix server collects from its agents. To do this, we are going to create a new MySQL database. So, create a specific user for this database and its required basic information. This account should not be logged in to MySQL with the root account.

To set up the MySQL database for Zabbix, log in to MySQL as the root user and type:

sudo mysql

Then, use the command below to create the Zabbix database with UTF-8 characters support.

create database zabbix character set utf8 collate utf8_bin;

It is time to create a user that the Zabbix server can use it. Also, give it access to the new database, and set the password for the user.

create user zabbix@localhost identified by 'your_zabbix_mysql_password';
grant all privileges on zabbix.* to zabbix@localhost;

In this way, the user and the database will be protected. Then, exit out of the database console.

quit;

When Zabbix is installed, you will have a file that sets the initial schema and data. So, to set up the schema and import the data into the Zabbix database.

zcat /usr/share/doc/zabbix-server-mysql*/create.sql.gz | mysql -uzabbix -p zabbix

zcat is used because the data in the file is compressed.

Now, you need to enter the password for zabbix MySQL user. Set the database password in the Zabbix server configuration file to let the Zabbix server use the database. To do this, open the configuration file in your favorite text editor. Here, we use nano.

sudo nano /etc/zabbix/zabbix_server.conf

The following section of the file must be shown.

/etc/zabbix/zabbix_server.conf

...
### Option: DBPassword                           
#       Database password. Ignored for SQLite.   
#       Comment this line if no password is used.
#                                                
# Mandatory: no                                  
# Default:                                       
# DBPassword=
...

Set the DBPassword value in the file to the password for your database user. Commands in the file explain the way you can connect to the database. To set up the database, Add this line after those commands.

/etc/zabbix/zabbix_server.conf

...
DBPassword=<span style="color: #0000ff;">your_zabbix_mysql_password</span>
...

If you used nano too, press CTRL+X , followed by Y, and then ENTER to save and close zabbix_server.conf .

Step 3

In this step, you are ready to set up Nginx for Zabbix. To do this automatically, you need to install the automatic configuration package. So, run:

sudo apt install zabbix-nginx-conf

Once you get the configuration file, make changes to that. So, open it to do this.

sudo nano /etc/zabbix/nginx.conf

An automatically generated Nginx server block configuration is present in the file. Two lines in it specify the server name and the port on which it is listening:

/etc/zabbix/nginx.conf

server {
<span style="color: #0000ff;">#        listen          80;</span>
<span style="color: #0000ff;">#        server_name     example.com;
</span>...

Uncomment the two lines and substitute your domain name for example.com. Your settings will appear as follows:

/etc/zabbix/nginx.conf

server {
        listen          80;
        server_name     <span style="color: #0000ff;">your_domain</span>;
...

Save the document, then exit. Next, verify that none of your Nginx files contain syntax problems, then reload the configuration:

sudo nginx -t
sudo nginx -s reload

You will need to adjust your PHP configuration after setting up Nginx to serve the Zabbix frontend for the web interface to function properly.

Step 4

It is time to Set up/Configure PHP for Zabbix. The PHP-based Zabbix web interface needs particular PHP server settings. These settings are stored in a PHP-FPM configuration file that was created during the Zabbix installation procedure. It is loaded automatically by PHP-FPM and can be found in the directory/etc/zabbix. This file needs a minor modification, so open it by doing the following:

sudo nano /etc/zabbix/php-fpm.conf

The PHP configurations in the file are appropriate for the Zabbix web interface. The timezone option, however, is by default uncommented. You must select the proper timezone for Zabbix for it to use the correct time:

/etc/zabbix/php-fpm.conf

...
php_value[max_execution_time] = 300
php_value[memory_limit] = 128M
php_value[post_max_size] = 16M
php_value[upload_max_filesize] = 2M
php_value[max_input_time] = 300
php_value[max_input_vars] = 10000
<span style="color: #0000ff;">; php_value[date.timezone] = Europe/Riga</span>

Uncomment the timezone line that was marked in the code block before it, then replace it with your timezone. Then save and close the file.

To apply these new settings, restart PHP-FPM.

sudo systemctl restart php7.4-fpm.service

To start the Zabbix server, run:

sudo systemctl start zabbix-server

Then verify the appropriate operation of the Zabbix server to view active (running) in your output. In the end, enable the server to start at boot time, set up the server, and connect to the database.

sudo systemctl enable zabbix-server

Step 5

When the required steps to install and Setup Zabbix on Ubuntu 20.04 are complete, you can set up settings for the Zabbix web interface. The web interface requires some basic setup before you can use it, but it allows you to view reports and add hosts that you want to monitor. Open your browser and navigate tohttp://zabbix server nameorhttps://zabbix server name if Let’s Encrypt has been configured. An introduction message will appear on the first screen. To proceed, select Next.

You may find the table with a list of all the requirements to run Zabbix on the next screen.

prerequisites to run Zabbix

Verify that all the values in this table are OK. Make sure to scroll down and review each need. After making sure everything is prepared, move on by clicking the Next step.

On the following screen, a database connection request is made.

database connection information

Although you informed the Zabbix server about your database, the web interface for managing hosts and reading data also requires access to the database. Enter the MySQL login information that you set up in Step 2 as a result. To continue, click Next step.

You can leave the selections on the following screen’s default values.

zabbix server details

To advance to the last screen, click Next step. The time zone and Zabbix GUI theme can be defined when we click Next Step (the timezone was previously changed in the apache.conf file).

Before we begin the installation, we get to examine all previous configurations after selecting Next Step.

setup-zabbix on ubuntu

Once you do everything correctly, the installation is complete. After the installation, a screen with a congratulations message will appear. The procedure for installing Zabbix on Ubuntu 20.04 was as follows.

setup zabbix on ubuntu

After that, we will be directed to the Zabbix monitoring login screen, where we must enter the password Zabbix and the username Admin.

main Zibbax dashboard

Create a new user with admin privileges, or change a default password for the Admin account to begin exploring and configuring Zabbix.

The destination path is Administration->Users and there you change the password or create a new user.

Step 6

Here is the last step to need to pass to Install and Setup Zabbix on Ubuntu 20.04. Since this step asks you to install and set up the Zabbix agent, you need to configure the agent software that will send monitoring data to the Zabbix server. To do this, log in to the second Ubuntu server first.

ssh opera@second_ubuntu_server_ip_address

Run the commands listed below to install the repository configuration package, the same as you would on the Zabbix server:

wget https://repo.zabbix.com/zabbix/5.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_5.0-1+focal_all.deb
sudo dpkg -i zabbix-release_5.0-1+focal_all.deb

And, to update the package index:

sudo apt update

Then, use the command below to install the Zabbix agent:

sudo apt install zabbix-agent

Although Zabbix supports certificate-based encryption, this tutorial does not cover how to set up a certificate authority. Pre-shared keys (PSK), however, can be used to secure the link between the server and the agent.

Create a PSK first:

sudo sh -c "openssl rand -hex 32 > /etc/zabbix/zabbix_agentd.psk"

Show the key by using cat, so you can copy it somewhere:

cat /etc/zabbix/zabbix_agentd.psk

Save the output to use it to configure the host later.

Edit the Zabbix agent settings to set up its secure connection to the Zabbix server. To do this, open the agent configuration file in your favorite text editor:

sudo nano /etc/zabbix/zabbix_agentd.conf

Then, edit the IP address of the Zabbix server and change the default value to the IP of your Zabbix server: