Skip to main content

macOS Installation

Install Breeze on macOS using the signed tarball and installer script.

Before You Begin​

Confirm that the target hosts meet the Requirements and can reach the Breeze service over TCP 443.

Download the Installer​

  1. In Cloudaware, go to Admin.
  2. Find Breeze in DevOps Integrations. Click CONFIGURED.
  3. Download the macOS agent archive (breeze-agent*.tgz) for your platform.

Install Breeze​

Run the installer as root (or with sudo):

tar xf breeze-agent*.tgz
cd breeze-agent
./install.sh

The installer configures a cron job to run every ~15 minutes and installs the agent under /opt/breeze-agent.

Verify the Installation​

  • Cron entry: cat /etc/cron.d/breeze-agent
  • Manual run: cd /opt/breeze-agent && ./app.sh
  • Logs (default): /opt/breeze-agent/var/log/breeze-agent.log for scheduled runs. Manual runs print to STDOUT.

After the first run completes successfully, the agent starts streaming OS-level facts into the Cloudaware CMDB and receives self-updates from Breeze Server when new versions are available.

Upgrade/Uninstall​

To upgrade Breeze, install a newer package over the existing installation. The configuration under /opt/breeze-agent is preserved.

To uninstall, run the uninstall script:

sudo /opt/cloudaware/breeze/uninstall.sh