[KB7722] Deploy ESET Management Agent using Agent script Installer via ESET PROTECT or ESET PROTECT On-Prem

Issue

Required user permissions

This article assumes that you have the appropriate access rights and permissions to perform the tasks below.

If you are unable to perform the tasks below (the option is unavailable), create a second administrator user with all access rights.

  • Deploy the ESET Management Agent via Agent Script Installer

Click the expanders below to show the procedure for ESET PROTECT or ESET PROTECT On-Prem:

ESET PROTECT
  • Deploy ESET Management Agent on all client computers where other ESET PROTECT components or ESET endpoint applications are installed using an Agent script installer

Solution

macOS and Linux users only

The deployment of the ESET Management Agent and the ESET endpoint application together from ESET PROTECT via an Agent script installer is available on macOS and Linux only.

Alternative deployment option (Windows and macOS users)

An alternative local deployment option is to create a Live Installer to deploy ESET Management Agent and ESET endpoint application.

New ESET PROTECT instance

If you create a new ESET PROTECT instance, deploy ESET endpoint applications to client computers.

Error 1603 when deploying the ESET Management Agent

Occasionally, during ESET Management Agent installation, the notification "Error code 1603 - Installation ended prematurely" will be displayed.

Use the following troubleshooting steps to resolve this error:

  • If you run the Agent script installer from a shared location, copy the script installer file to the local disk and attempt the installation again.
  • If the issue persists, collect and submit an ESET Sysinspector log for ESET Technical Support.

  2. Click Quick links and click macOS devices or Linux devices (in this example, macOS devices have been selected).

  3. Click Customize Installer.

  4. Select Deploy Agent first (Agent script installer). You can deselect the check box next to Participate in application improvement program if you do not want to help ESET improve our application. Under the Parent Group, click Select or Create to select or create a group where ESET PROTECT will place the computer after an Agent installation. Read more about Parent Groups. Optionally, click Customize more settings to review additional settings. Click Save & Download.

  5. Download and run the installation package file on a client computer. It will install the ESET Management Agent and connect it to ESET PROTECT.

Read more information on how to create an Agent script installer.

ESET PROTECT On-Prem

Solution

New ESET PROTECT On-Prem installation

If you are performing a new installation of ESET PROTECT On-Prem, deploy or upgrade ESET endpoint applications using ESET PROTECT On-Prem.

Peer certificates and Certification Authority

Peer certificates and Certification Authority created during the installation are, by default, contained in the Static Group All.

Deploy ESET Management Agent using the Agent script installer

  2. Click Quick Links → Deploy Agent.

  3. Based on your operating system, follow the steps below to deploy ESET Management Agent on Windows, macOS, or Linux.

Deploy ESET Management Agent on Windows

    1. Select Windows and verify that the Deploy Agent first (Agent script installer) option is selected. Configure other settings as needed. Optionally, click Customize more settings to review additional settings. Click Save & Download.

    2. Follow these steps to deploy ESET Management Agent on Windows client computer.
Deploy ESET Management Agent on macOS

    1. Select macOS and configure other settings as needed. Optionally, click Customize more settings to review additional settings. Click Save & Download.

    2. Follow these steps to deploy ESET Management Agent on macOS client computer.

Deploy ESET Management Agent on Linux

    1. Select Linux and configure other settings as needed. Optionally, click Customize more settings to review additional settings. Click Save & Download.

    2. Follow these steps to deploy ESET Management Agent on Linux client computer.

Troubleshooting

  • If you receive a "Failed to get installers" or "Failed to synchronize package repository" error while performing the steps below, your third-party firewall could be blocking certain communications based on the country of origin. If this is the case, we recommend allowing communications for ESET PROTECT On-Prem repository.

  • Occasionally, during ESET Management Agent installation, the notification "Error code 1603- Installation ended prematurely" will be displayed. Use the following troubleshooting steps to resolve this error:

Last Updated: Feb 23, 2026

Additional resources

User guides

ESET Forum

YouTube videos
ESET Support News ESET Customer Advisories ESET Status Portal ESET Technical Support

Existing customer?