Create Agent Live Installer

This type of Agent deployment is useful when the remote and local deployment options do not suit you. In such cases, you can distribute the Agent Live Installer via email and let the user deploy it. You can also run the Agent Live Installer from removable media (a USB flash drive, for example).


The client machine needs to have an internet connection to download the Agent installation package. Also, the client needs to be able to connect to the ERA Server.

Click Deploy ERA Agent in the Quick Links section of the menu bar. In the Deploy Agent window, click Create installer button under Create Agent Live Installer. The Agent Live installers window will open.

Package creation

icon_section Certificate - A Peer Certificate and ERA Certification Authority is chosen automatically based on the available certificates. If you want to use a different certificate than the one automatically selected, click the ERA Certificate description to select from a list of available certificates. If you want to use a Custom certificate, click the radio button and upload a .pfx certificate file. See Custom certificates with ERA for further details.

Enter a Certificate passphrase if needed. For example, if you've specified the passphrase during the installation of ERA, or if you are using a custom certificate with a passphrase. Otherwise, leave the Certificate passphrase field blank.

validation-status-icon-warning IMPORTANT

The certificate passphrase must not contain following characters: " \ These characters cause critical error during the initialization of the Agent.

icon_section Configuration - In this section, you can customize the following settings for the Agent Live installer package:

1.Optionally, you can change the Name and enter Description for your package installer.

2.Server hostname - If necessary, you can specify the ERA Server Hostname and Port number. Otherwise, leave default values unchanged.

3.Parent group (optional)- Select the Parent group where the computer will be placed after the installation. If you want to create a new Parent Static group, click New Static group and use the wizard. The newly created group will automatically be selected.

4.Click Get Installers to generate links for Windows, Linux and macOS Agent installer files.


5.Click Download next to the installer file(s) that you want to download and save the zip file. Unzip the file on the client computer where you want to deploy ERA Agent and run EraAgentOnlineInstaller.bat (Windows) or script (Linux and macOS) to run the installer. For instructions on how to deploy the ERA Agent on a client using the Agent Live Installer, see our KB article.


If you are running the script on Windows XP SP2, you need to install Microsoft Windows Server 2003 Administration Tools Pack. Otherwise, the Agent Live Installer won't run properly. Once you have installed the Administration Pack, you can run the Agent Live Installer script.


Check the status log on the client machine C:\ProgramData\ESET\RemoteAdministrator\Agent\Logs\status.html to make sure ERA Agent is working properly. If there are problems with the Agent (for example, it is not connecting to the ERA Server), see troubleshooting.

To deploy the ERA Agent using Agent Live Installer from your local shared folder without the ESET Repository Download Server, follow these steps:


1.Edit the EraAgentOnlineInstaller.bat file.  or script (Linux and macOS).

2.Change lines 30 and 33 to point to the correct local download files. The original file looks like:


3.Use your own URL (local shared folder), instead of the one shown below:



Agent Live Installer verifies integrity of installation files based on their checksum (see lines 31 and 34). This is a unique string generated for each file. In case the file changes, its checksum changes as well.

validation-status-icon-warning IMPORTANT

Make sure that the user account under which the installation package is executed has write permission to the local shared folder. The path can contain spaces, for example \\server\shared folder\Agent_x64.msi (do not use quotation marks "").

4.Edit line 76 to replace " echo.packageLocation = DownloadUsingHTTPProxy^("!url!", "!http_proxy_hostname!", "!http_proxy_port!", "!http_proxy_username!", "!http_proxy_password!"^) "


with echo.packageLocation = "!url!"


5.Save the file.


1.Open the script in a text editor.

2.Delete lines: 52, 53 and 56-68.


3.Replace lines 138-159 with the path to your local installer. See the highlighted area in the image. Use your own URL (local shared folder), instead of the one shown below.



5.Save this file.



1.Open the script in a text editor.

2.Delete lines: 27 and 28:


3.Insert the following line with the paths to your local i386 installer.


4.Replace lines 34 - 41 with the path to your local x86_64 installer. See the highlighted area in the image. Use your own URL (local shared folder), instead of the one shown below.



5.Delete lines 53 - 65.


6.Save this file.