Upgrade agents remotely

You can upgrade Wazuh agents remotely from the Wazuh manager. The Wazuh manager sends a Wazuh signed package (WPK) file to each enrolled agent. The WPK file contains the files required to upgrade the Wazuh agent to the selected version. This streamlines the upgrade process across your installation and eliminates the need to access each agent individually.

WPK files are archive files used for distributing and installing updates or new versions of the Wazuh agent on various operating systems. Wazuh provides access to an updated WPK repository for each new release. The following tables list the available WPK files.

WPK List

Linux

Distribution	Version	Architecture	WPK Package
Linux (deb)	5.0.0	x86_64/AMD64	wazuh_agent_v5.0.0_linux_amd64.deb.wpk
Linux (deb)	5.0.0	ARM64	wazuh_agent_v5.0.0_linux_arm64.deb.wpk
Linux (rpm)	5.0.0	x86_64/AMD64	wazuh_agent_v5.0.0_linux_x86_64.rpm.wpk
Linux (rpm)	5.0.0	ARM64	wazuh_agent_v5.0.0_linux_aarch64.rpm.wpk

Windows

Distribution	Version	Architecture	WPK Package
Windows	5.0.0	32/64bit	wazuh_agent_v5.0.0_windows.wpk

macOS

Distribution	Version	Architecture	WPK Package
macOS	5.0.0	Intel 64	wazuh_agent_v5.0.0_macos_intel64.pkg.wpk
macOS	5.0.0	ARM64	wazuh_agent_v5.0.0_macos_arm64.pkg.wpk

Note

Direct upgrades to Wazuh agent 5.0.0 are not supported from Wazuh agent 4.14.0 or earlier. Upgrade the Wazuh agent in this order: 4.14.0 or earlier > 4.14.x > 5.0.0.

Upgrade the Wazuh agent using a WPK file

Follow these steps to upgrade a Wazuh agent using a WPK file:

Download the corresponding WPK package on the Wazuh manager. This example uses the Linux AMD64 WPK package. We recommend that you download the WPK file to /var/wazuh-manager/tmp/:

# wget -P /var/wazuh-manager/tmp/ https://packages-staging.xdrsiem.wazuh.info/pre-release/5.x/wpk/linux/deb/amd64/wazuh_agent_v5.0.0_linux_amd64.deb.wpk

The command output looks similar to this:

--2026-06-02 13:39:20--  https://packages-staging.xdrsiem.wazuh.info/pre-release/5.x/wpk/linux/deb/amd64/wazuh_agent_v5.0.0_linux_amd64.deb.wpk
Resolving packages-staging.xdrsiem.wazuh.info (packages-staging.xdrsiem.wazuh.info)... 3.162.125.88, 3.162.125.62, 3.162.125.83, ...
Connecting to packages-staging.xdrsiem.wazuh.info (packages-staging.xdrsiem.wazuh.info)|3.162.125.88|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 14004881 (13M) [binary/octet-stream]
Saving to: '/var/wazuh-manager/tmp/wazuh_agent_v5.0.0_linux_amd64.deb.wpk.1'
wazuh_agent_v5.0.0_linux_amd64 100%[==================================================>]  13.36M  21.3MB/s    in 0.6s
2026-06-02 13:39:21 (21.3 MB/s) - '/var/wazuh-manager/tmp/wazuh_agent_v5.0.0_linux_amd64.deb.wpk.1' saved [14004881/14004881]

Run the agent_upgrade tool and specify the agent ID of the Wazuh agent you want to upgrade. This example upgrades agent 002 which has Wazuh agent 4.14.5 installed.

# /var/wazuh-manager/bin/agent_upgrade -a 002 -f /var/wazuh-manager/tmp/wazuh_agent_v5.0.0_linux_amd64.deb.wpk

The command output looks similar to this:

Upgrading...

Upgraded agents:
        Agent 002 upgraded: v4.14.5 -> v5.0.0

It is possible to specify multiple agent IDs using this method:

# /var/wazuh-manager/bin/agent_upgrade -a 002 003

The command output looks similar to this:

Upgrading...

Upgraded agents:
        Agent 002 upgraded: v4.14.5 -> v5.0.0
        Agent 003 upgraded: v4.14.5 -> v5.0.0

Verify the Wazuh agent version from the Wazuh dashboard.

Verify the version from the Wazuh agent endpoint:

# /var/ossec/bin/wazuh-control info

The command output looks similar to this:

WAZUH_VERSION="v5.0.0"
WAZUH_REVISION="beta3"
WAZUH_TYPE="agent"