dotlinux blog

How to Install Zabbix Agent and Add Windows Host to Zabbix Monitoring

In today's complex IT environments, visibility is everything. You can't manage what you don't monitor. Zabbix stands as one of the most powerful and popular open-source monitoring solutions, capable of tracking the performance and health of thousands of servers, network devices, and applications.

While Zabbix excels at monitoring Linux systems, a significant portion of enterprise infrastructure runs on Windows. Monitoring these Windows hosts—tracking CPU, memory, disk usage, service states, and performance counters—is crucial for maintaining overall system health and preventing costly downtime.

This detailed, step-by-step guide will walk you through the entire process: from downloading the correct Zabbix Agent software to successfully integrating your Windows server or workstation into your Zabbix monitoring ecosystem. By the end of this blog, you will have a fully monitored Windows host providing valuable insights into its operations.

2026-03

Table of Contents#

  1. Prerequisites
  2. Step 1: Download the Zabbix Agent
  3. Step 2: Install the Zabbix Agent on Windows
  4. Step 3: Configure the Zabbix Agent
  5. Step 4: Open the Windows Firewall Port
  6. Step 5: Add the Windows Host to the Zabbix Server
  7. Step 6: Verify Agent Communication and Data Collection
  8. Troubleshooting Common Issues
  9. Conclusion
  10. References

Prerequisites#

Before you begin, ensure you have the following:

  • A Windows Host to Monitor: This can be a physical server, a virtual machine (VMware, Hyper-V), or a cloud instance (AWS EC2, Azure VM) running a supported version of Windows (e.g., Windows Server 2012 R2 and later, Windows 10/11).
  • Administrative Access: You need local administrator privileges on the Windows machine to install software and configure the firewall.
  • Zabbix Server Details: You must know the IP address or hostname of your Zabbix server.
  • Network Connectivity: The Windows host must have network connectivity to the Zabbix server on the port used by the agent (default is TCP/10050). The Zabbix server must also be able to initiate connections to the agent on this port.

Step 1: Download the Zabbix Agent#

  1. Go to the official Zabbix Download Page.
  2. Scroll down to the "Zabbix Agents" section.
  3. Select "Microsoft Windows" as your platform.
  4. Choose the appropriate installation package. For most users, the MSI package is the easiest option. If you need more control or are automating the deployment, the ZIP archive is suitable.
    • MSI Installer: zabbix_agent-<version>-windows-<architecture>.msi
    • ZIP Archive: zabbix_agent-<version>-windows-<architecture>.zip
    • Make sure to select the correct architecture (e.g., i386 for 32-bit, amd64 for 64-bit) for your Windows system. Most modern systems are 64-bit (amd64).

Note: It is highly recommended to use a version of the Zabbix Agent that matches the version of your Zabbix Server.

Step 2: Install the Zabbix Agent on Windows#

This method provides a graphical wizard for a straightforward installation.

  1. Locate the downloaded .msi file and double-click to run it.

  2. Click "Next" on the welcome screen.

  3. Accept the license agreement and click "Next".

  4. On the "Custom Setup" screen, you can leave the default settings and click "Next".

  5. The "Configuration Parameters" screen is critical. Here you will enter the connection details for your Zabbix Server.

    • Zabbix Server IP / DNS name: Enter the IP address (e.g., 192.168.1.100) or hostname (e.g., zabbix.example.com) of your Zabbix server.
    • Zabbix Server Port: The default is 10051. Leave this as is.
    • Hostname: This is a very important field. Enter the hostname by which the Zabbix server will identify this agent. It is highly recommended to use the Windows machine's actual hostname. You can find this by running hostname in the Command Prompt. For example, if the hostname is WIN-SERVER-01, enter that exactly.
    • Host Metadata (Optional): You can specify metadata here (e.g., windows or production) which can be used for automatic host registration in more advanced setups.

    MSI Configuration Screen (Image credit: Zabbix Documentation)

  6. Click "Next" and then "Install". The installer will copy the files and install the Zabbix Agent as a Windows Service.

  7. Click "Finish". The agent service will now be running.

Method B: Manual Installation using the ZIP Archive#

This method offers more control and is ideal for scripted deployments.

  1. Extract the contents of the downloaded ZIP file to a directory on your Windows host, for example, C:\Program Files\Zabbix Agent\.
  2. Open the extracted folder. You will see several files, including zabbix_agentd.exe (the main agent daemon) and configuration files like zabbix_agentd.conf and zabbix_agentd.win.conf.
  3. Rename zabbix_agentd.win.conf to zabbix_agentd.conf. This is the main configuration file we will edit.
  4. Edit the zabbix_agentd.conf file with a text editor like Notepad++ or VS Code (running as Administrator). You need to change at least the following parameters: 
    # Zabbix Server IP address
Server=192.168.1.100
 
# For active checks, the agent connects to the server.
# For passive checks, the server connects to the agent.
# It's good practice to list both the Zabbix server and the host itself (for local checks).
ServerActive=192.168.1.100
 
# The unique hostname. Must match the hostname configured on the Zabbix server.
Hostname=WIN-SERVER-01
 
# (Optional) Log file location
LogFile=C:\Program Files\Zabbix Agent\zabbix_agentd.log
 
# (Optional) Directory for including custom .conf files
Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\
  5. Save the configuration file.
  6. Install the Agent as a Service: Open a Command Prompt as Administrator.
  7. Navigate to the agent directory: cd "C:\Program Files\Zabbix Agent".
  8. Run the following command to install the service: 
    zabbix_agentd.exe --install
  9. Start the service: 
    zabbix_agentd.exe --start
    You can also start it from Services.msc; the service will be named "Zabbix Agent".

Step 3: Configure the Zabbix Agent#

If you used the MSI installer, the configuration was done during setup. If you used the manual method, you've already edited the conf file. The key parameters are:

  • Server: Defines the IP/FQDN of the Zabbix server that is allowed to request passive checks from this agent.
  • ServerActive: Defines the IP/FQDN of the Zabbix server to which the agent will send active checks.
  • Hostname: This is the most important setting. The value must exactly match the hostname you will use when creating the host in the Zabbix frontend. Mismatches are the most common cause of hosts showing as "unavailable".

After making any changes to the configuration file, you must restart the Zabbix Agent service for the changes to take effect. You can do this from the Services manager (services.msc) or from an admin command prompt: zabbix_agentd.exe --restart.

Step 4: Open the Windows Firewall Port#

By default, the Zabbix Agent listens on TCP port 10050. You must create a firewall rule to allow the Zabbix server to communicate with the agent.

  1. Open Windows Defender Firewall with Advanced Security.
  2. Click on Inbound Rules in the left pane.
  3. Click New Rule... in the right pane.
  4. Select Port and click Next.
  5. Select TCP and specify the port: 10050. Click Next.
  6. Select Allow the connection and click Next.
  7. Select the profiles (Domain, Private, Public) where the rule should apply. Typically, you would at least enable it for the "Domain" and "Private" profiles. Click Next.
  8. Give the rule a name, e.g., "Zabbix Agent Port 10050", and click Finish.

Your Zabbix server should now be able to communicate with the agent on port 10050.

Step 5: Add the Windows Host to the Zabbix Server#

Now, we need to tell the Zabbix server about the new host.

  1. Log in to your Zabbix web frontend as an administrator.

  2. Navigate to Configuration -> Hosts.

  3. Click the Create host button in the top-right corner.

  4. Fill in the host details:

    • Host name: Enter the exact same hostname you configured in the agent's zabbix_agentd.conf file (e.g., WIN-SERVER-01). This is case-sensitive.
    • Visible name: (Optional) A more descriptive name for display in the frontend (e.g., "Production Web Server").
    • Groups: This is essential. Select one or more groups. A good starting point is to add the host to the "Windows servers" group. You may need to click "Select" and then "Add" to assign it. Groups are used for permissions and mass actions.
    • Agent interfaces: Click Add and enter the IP address or DNS name of the Windows host and the agent port (10050). For example, 192.168.1.50 Port 10050.

  5. Link Templates: This is a crucial step to start collecting data. Go to the Templates tab.

    • In the "Link new templates" field, type Template OS Windows by Zabbix agent.
    • Select it from the dropdown. This template contains a collection of items, triggers, graphs, and discovery rules specifically for monitoring Windows systems.
    • You can also add other templates, like Template App Windows Service by Zabbix agent to monitor specific services.

  6. Click the Add button at the bottom of the form to create the host.

Step 6: Verify Agent Communication and Data Collection#

After adding the host, it will take a minute or two for Zabbix to perform its first checks.

  1. Go back to Configuration -> Hosts.

  2. Find your new host in the list.

  3. Check the Availability column for the ZBX icon. It should turn green, indicating that the Zabbix server can communicate with the agent.

    • Green ZBX: Communication is successful.
    • Red ZBX: Communication has failed. Check the hostname, IP address, firewall, and agent service status.

  4. To see the collected data, go to Monitoring -> Hosts, select your host, and then explore the Latest data section. You should see data for metrics like CPU utilization, memory usage, disk space, etc.

Troubleshooting Common Issues#

  • Host shows as "Unavailable" (Red ZBX icon):

    • #1 Cause: Mismatch between the Hostname in zabbix_agentd.conf and the "Host name" in the Zabbix frontend. Double-check both!
    • Verify the Zabbix Agent Windows service is running.
    • Check the firewall rule on the Windows host. Can you telnet to port 10050 from the Zabbix server? (telnet <windows_host_ip> 10050).
    • Check the agent log file (C:\Program Files\Zabbix Agent\zabbix_agentd.log) for errors.

  • No data in "Latest Data":

    • The host is likely available, but the items might not be collecting data. Ensure you have linked the correct template (e.g., Template OS Windows by Zabbix agent).
    • Check the item list in Configuration -> Hosts -> [Your Host] -> Items. There should be many items with a green "Enabled" status.

  • Agent fails to start:

    • Check the configuration file for syntax errors. There should be no spaces around the = sign.
    • Ensure you are running the command prompt as Administrator when installing the service.

Conclusion#

Congratulations! You have successfully installed the Zabbix Agent on a Windows host and integrated it into your Zabbix monitoring platform. You now have visibility into key performance metrics of your Windows system, allowing you to proactively identify and resolve issues before they impact users.

This is just the beginning. Zabbix offers a vast array of possibilities for Windows monitoring, including custom performance counters, service monitoring, event log tracking, and more. Explore the templates and consider creating your own custom items and triggers to tailor the monitoring to your specific needs.

References#

  1. Zabbix Official Documentation: Installing Zabbix agents on Windows
  2. Zabbix Download Page
  3. Zabbix Template: Template OS Windows by Zabbix agent (GitHub)