Breeze Agent 3.x Compatibility & Support

This guide provides summary on supported operating systems, architectures, packaging, cloud platforms, and migration co-existence guidance.

Supported Operating Systems

Breeze Agent 3.x is tested on the same core platforms as the general agent, including:

Linux: Amazon Linux 1, 2, and 2023; RHEL / CentOS 7+; Debian 8+; Ubuntu 14.04+.
Windows: Windows Server 2012 and newer, including Server Core.
macOS: not supported for migration from Breeze Agent 1.x.

On Amazon Linux 2023 and RHEL 10, the installer adds the libxcrypt-compat package the agent needs. See Installation.

Linux: x86_64 and arm64 (aarch64), distributed as signed archives with an install script.
Windows: x86_64 installer executable.
macOS: x86_64 (Intel) and arm64 (Apple Silicon), distributed as signed .pkg installers. macOS is not supported for migration from Breeze Agent 1.x.

First-class support for major public clouds (AWS, Azure, GCP, Oracle Cloud) where instance metadata access is required for full functionality.
VMware and Nutanix AHV virtual machines.
Kubernetes support via a containerized agent that runs as a Deployment in the cluster, not as a DaemonSet on each node. The agent registers the cluster itself (Amazon EKS, Azure AKS, Google GKE, or another Kubernetes cluster) and publishes the facts TunHub needs to reach it.

To force a particular registration when a host matches more than one platform, see Preferred Descriptor.

Breeze Agent 3.x installs next to Breeze Agent 1.x in a separate directory. Both agents run side by side on the same host until 1.x is removed.
Breeze Agent 1.x is removed in two stages after 3.x is reporting: first its scheduled task is disabled, then its installation directory is deleted.
Check Feature Availability before you migrate a host, then use the Migration guide and Changelog to plan rollouts and understand any behavioral differences.