Install software via Chocolatey

We've made remote software installation easy with our Chocolatey API integration. Chocolatey enables a secure, efficient, silent, and complete installation in just a few clicks. No more manually figuring out system requirements, searching for the latest versions, or multi-part downloads followed by installation wizards. Our integration with Chocolatey helps take the headache out of being a system administrator. Learn more about Chocolatey.

Notes:

• For the Software Installation feature to work, you may need to whitelist the following servers: chocolatey.org and packages.chocolatey.org.
• AteraAgent is running under the Local System account hence software that installs on a per-user basis via Chocolatey will only install on the system user and will not be visible to other users. 
• If you receive the error 429 Too Many Requests, you have triggered the rate limit. Currently, the rate limit will be in place for one hour. If you trigger it again, it will then be set for another hour. Learn more here.

Single-Device Installation

You can install software via Chocolatey on a single device.

To install software: 

1. Click Devices (on the side panel) to see your devices (or to access a specific customer's devices, go to Customers (on the side panel) > the specific customer > Devices tab).

 The device list appears.

Note: Software can be installed on a device from within the Agent Console as well.

2. Click the Manage dropdown menu, next to the specific device, and select Software Installation. 

The Software Installation form appears.

3. Enter the full or partial name of the software you wish to install (autocomplete will bring up all relevant matches).

Once the software is selected, you have the option of entering parameters for a customized installation. When available, a list of package parameters along with descriptions are displayed.

4. Click Install, to install the software.

The installation begins. An installation success (or failure message) appears within a few minutes informing you of the outcome.

Multiple-Device Installation

You can install software via Chocolatey on all or some of a customer's devices (or on devices within a customer folder).

To install software: 

1) From Customers (on the side panel), click on the specific customer.

The Customer page appears.

2) From within the customer's page, click the Devices tab, then the All tab. 

3. Select the specific device(s) by checking the checkbox(es) next to the device(s).

4. Then click the (Software Installation) icon from the row of icons above.

The Software Installation form appears.

5. Fill out the form:

• Select the device(s) on which to install the software. There is an option to select all devices. 
• Select an 'Automation Expiration' specification. You can choose to install software on online agents only, or specify how long to keep the task in queue until the device(s) are back online.
• Enter the full or partial name of the software you wish to install (autocomplete will bring up all relevant matches), and click your selection.

Once the software is selected, you have the option of entering parameters for a customized installation. When available, a list of package parameters along with descriptions are displayed.

6. Click Install, to install the software.

The installation begins. An installation success (or failure message) appears within a few minutes informing you of the outcome. The installation can also be seen within the event logs on the specific device(s).

Note: You can install software on multiple devices from the Devices page as well. Just check to select all or some of your customer devices and click the  icon.

Related articles

• Troubleshoot: Software installation
• Install Software Via Homebrew
• Create and Install Software Bundles
• Automate software patching (via chocolatey and homebrew)