Skip to main content
Skip table of contents

Breeze 3.0 - Configuration

Overview

The configuration file is located in the home directory (see BREEZE_HOME_DIR) of the Breeze agent. Below is a list of environment variables that will be inherited when the agent is started.

Linux/macOS

  • Filename: etc/env.sh

  • Format: POSIX-compatible shell (ENV=VALUE without quotes)

  • Example:

    CODE
    BREEZE_HOME_DIR=/opt/cloudaware/breeze
    http_proxy=<http://user:password@proxy-host:3128>

Windows

  • Filename: etc\\env.cmd

  • Format: Command shell (set ENV=VALUE without quotes)

  • Example:

    CODE
    set BREEZE_CLIENT_CERTIFICATE=etc\\certificate.crt
    set BREEZE_CLIENT_PRIVATE_KEY=etc\\private_key.key

Environment variables

BREEZE_CLIENT_CERTIFICATE

Description

Required, String. The path to the client certificate file.

BREEZE_CLIENT_PRIVATE_KEY

Description

Required, String. The path to the client private key file.

BREEZE_COLOR

Description

Optional, Boolean. Color the output of the agent.

Default value

true

BREEZE_DEBUG

Description

Optional, Boolean. Debug mode.

Default value

false

BREEZE_HOME_DIR

Description

Optional, String. The path to the agent's home directory.

Default value

  • Linux/macOS: /opt/cloudaware/breeze

  • Windows: C:\\Program Files\\Cloudaware\\Breeze

BREEZE_LOCAL_MODE

Description

Optional, Boolean. For development, run the agent without syncronizing with the Breeze server.

Default value

false

BREEZE_LOG_FILE

Description

Optional, String. The path to the log file. The output will be written to STDOUT by default.

BREEZE_PLUGIN

Description

Optional, String. For development, force the run only the specified plugin.

BREEZE_PREFERRED_DESCRIPTOR

Description

Optional, String. Force the specified instance descriptor to be set if the necessary data for it is available.

Known instance descriptors:

  • aws - AWS EC2 instance

  • azure_ss_vm - Azure Scale Set VM

  • azure_vm - Azure VM

  • gce - Google Compute Engine instance

  • intune - Microsoft Intune device

  • jamf - JAMF device

  • oracle_iaas_instance - Oracle Cloud Infrastructure instance

  • physical - Physical device

  • vmware_vm - VMware VM

BREEZE_SCHEDULER_USER

Description

Optional, String. Specify the user from whom the scheduled task will be launched (Linux/macOS only).

BREEZE_SERVER_URL

Description

Required, String. Breeze server URL.

BREEZE_STATUS_RETRIES

Description

Optional, Integer. The number of attempts to determine the status of the agent with the breeze status command.

Default value

1

BREEZE_TIMEOUT

Description

Optional, Integer. The number of seconds of timeout before the agent starts. Used for a scheduled task.

Default value

Random number from 0 to 30.

BREEZE_VERBOSE

Description

Optional, Boolean. Verbose output mode.

Default value

false

http_proxy

Description

Optional, String. The URL of the proxy server. HTTP_PROXY can be used, but is deprecated.

SSL_CERT_FILE

Description

Optional, String. The path to the custom CA bundle file (can be used with a HTTPS MITM proxies).

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.