docs / https / zabbix-agent-install-debian

zabbix agent install ( bookworm_12)

https updated 2025-07-25
textcopy
wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_7.0-1+debian12_all.deb
dpkg -i zabbix-release_7.0-1+debian12_all.deb
apt update
textcopy
apt install -y zabbix-agent
textcopy
nano /etc/zabbix/zabbix_agentd.conf

Change the following lines:

textcopy
Server=127.0.0.1

Replace with the IP address of your Zabbix server (parent VM):

textcopy
Server=ZABBIX_SERVER_IP 

Optional: To allow server and frontend connections, also set:

textcopy
ServerActive=ZABBIX_SERVER_IP

(Optional but recommended) Set a hostname for this VM:

textcopy
Hostname=debian12-vm-01 

Save and exit: Press Ctrl+X, then Y, then Enter.

textcopy
systemctl restart zabbix-agent 
textcopy
systemctl enable zabbix-agent

The agent will now listen on port 10050 (default).

Confirm it’s running:

textcopy
systemctl status zabbix-agent

Allow Zabbix Server to Access the Agent (if you use a firewall)

If using UFW:

textcopy
ufw allow from ZABBIX_SERVER_IP to any port 10050 proto tcp

Log in to your Zabbix web interface: http://ZABBIX_SERVER_IP/zabbix

Navigate to**:****Data collection > Hosts

Click : CREATE HOST

Fill in the new host details:

Host name: (Use the same as Hostname in agent config, e.g. debian12-vm-01)

Visible name: (optional–displayed in UI, can match host name)

Groups: Click “Select” and choose an existing group like “Linux servers,” or create your own.

Agent interfaces:

IP address: IP of the Debian 12 VM

Port: 10050 (default)

Leave “DNS name” blank unless using DNS

Assign a Template: (Ensures correct monitoring items are created automatically)

Go to the “Templates” tab.

Click “Select.”

Search for and choose Template OS Linux by Zabbix agent.

Click “Add” to attach the template.

Click “Add” at the bottom of the Host creation page to save the configuration.

Confirm Data Collection

  • Go to “Monitoring” → “Hosts” or “Latest data”
  • Within a minute or two, the host’s status should display as green (enabled/monitored) and data will start appearing.