ESET PRIVATE Scanning Solutions – Table of Contents

Example Deployment on an Ubuntu Host

In the example below, the Scanner Agent is deployed on an Ubuntu host running the Docker Engine. This setup is intended for evaluation and testing purposes, where the Scanner Agent receives files from a predefined directory on the host and submits them for scanning.

Prerequisites

Docker Engine installed and running on the Ubuntu host.

Access to the ESET Azure Container Registry with valid credentials.

A directory on the host that contains the files to be scanned (/home/samples).

1.Create a working directory

Create a dedicated working directory for the Scanner Agent configuration:

 

2.Create the Docker Compose file

Create a Docker Compose configuration file docker-compose.yml inside this directory:


note

The host path /home/samples is mounted into the container as a read‑only volume at /mnt/samples.

Place the files you want to scan under /home/samples on the host, the Scanner Agent will access and process them from this directory.

This simple Compose setup keeps the Scanner Agent in a stable state (sleep infinity) so that the container remains running while you copy test files into /home/samples and verify connectivity and scanning behavior. For production‑oriented or automated workflows, you can extend this configuration with additional services, logging, health checks, and orchestration logic as needed.


note

It is recommended to use and reference the latest available Scanner Agent image (in place of scanner_agent:1.X.X-amd64), as newer builds may include bug fixes, security patches, performance improvements, and quality‑of‑life changes. Always check the ESET Azure Container Registry or the provided Helm/image documentation for the current version before deploying in any environment.

 

3.Authenticate to the container registry

Use the ESET‑provided credentials to authenticate to the ESET Azure Container Registry:

 

4.Start the container

From the working directory, start the Scanner Agent container in detached mode:

This command pulls the image (if not already present) and starts the scanner_agent container in the background.