Agent installation - macOS

You can install ESET Management Agent on macOS in two ways:

Remotely - Using the Server task Agent deployment. If you experience problems deploying ESET Management Agent remotely (the Server task Agent deployment ends with a failed status), refer to Agent deployment troubleshooting.

Locally - See the instructions below.


ESET PROTECT Server and the ESET PROTECT Web Console are installed (on a Server computer).

An Agent certificate is created and prepared on your local drive.

A Certification Authority is prepared on your local drive (only needed for unsigned certificates).


Follow the steps below to install the ESET Management Agent component locally on macOS:


Make sure to meet all the installation prerequisites listed above.

1.Get the installation file (standalone agent installer .dmg) from the ESET download site or your system administrator.

2.Double-click the Agent-MacOSX-x86_64.dmg file and then double-click the .pkg file to start the installation.

3.Proceed with the installation. When asked, type the Server connection data:

Server hostname: hostname or IP address of the ESET PROTECT Server

Server port: port for Agent - Server communication, default is 2222.

Use Proxy: click if you want to use HTTP Proxy for Agent - Server connection.


This proxy setting is used only for (replication) between ESET Management Agent and ESET PROTECT Server, not for the caching of updates.

Proxy hostname: hostname or IP address of the HTTP Proxy machine.

Proxy port: default value is 3128.

Username, Password: type the credentials used by your proxy if it uses authentication.

You can change proxy settings later in your policy. Proxy must be installed before you can configure an Agent - Server connection via Proxy.

4.Select a Peer certificate and a password for this certificate. Optionally, you can add a Certification Authority.


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

5.Review the install location and click Install. The Agent will be installed on your computer.

6.The ESET Management Agent log file can be found here:

/Library/Application Support/com.eset.remoteadministrator.agent/Logs/


The communication protocol between Agent and ESET PROTECT Server does not support authentication. Any proxy solution used for forwarding Agent communication to ESET PROTECT Server that requires authentication will not work.

If you choose to use a non-default port for the Web Console or Agent, it may require a firewall adjustment. Otherwise, the installation may fail.