# About Patch Agent

The Patch Agent is a LaunchDaemon that runs by default every 4 hours to install or update specified applications. You can specify the applications that the Patch Agent will attempt to install or update using a Configuration Profile (opens new window). When installing Alectrona Patch on a Mac where a Patch Configuration Profile exists, this results in Alectrona Patch performing automated patch management client-side on your Mac based on your own specifications.

The Patch Agent is located at the following path:

/Library/Application Support/Alectrona/Patch/patch-agent

# Controlling the Patch CLT

The Patch Agent creates a job list based on the Configuration Profile installed on a Mac. It then takes this job list and begins to perform installations/updates by leveraging the Patch CLT. Once the Patch CLT is done installing/updating the application, it then notifies the Patch Agent that the installation was successful, and the Patch Agent moves on to the next software title in its job list.

# Patch Agent Preferences

Used to customize the Patch Agent for your organization.

Domain: com.alectrona.patch-agent

Key Description Data Type Example
InstallOrUpdate A list of software titles to install even if they are not currently installed. Array of Strings <key>InstallOrUpdate</key>
<array>
    <string>title1</string>
    <string>title2</string>
</array>
UpdateOnly A list of software titles to update if they are installed and out-of-date. Array of Strings <key>UpdateOnly</key>
<array>
    <string>title1</string>
    <string>title2</string>
</array>
ReconAfterInstall Configures the Patch Agent to perform a Jamf Pro inventory update after executing if a software title is installed or updated. Note: This does not include manual installations using the Patch CLT. Boolean <key>ReconAfterInstall</key>
<true/>
DeferIfRunning If an app is running and an update occurs, setting this key to true will suppress the update dialog and will automatically perform a deferral. Boolean <key>DeferIfRunning</key>
<true/>

TIP

Some of these items can be configured easily with our Profile Builder.