ClamAV AntiVirus for Preside

Overview

This extension provides anti virus scanning using ClamAV for files uploaded to Preside. See Wiki for complete usage documentation.

Requirements

The extension required Preside 10.10 and above.

Installation

Install the extension to your application using CommandBox:

box install preside-ext-clamav

Remote ClamAV service

As of 2.0.0, this extension offers support for ClamAV running on a separate machine from your running Preside application. For example, in a Kubernetes cluster, you may run the clamav/clamav docker image as a service that your Preside applications can communicate with.

In order to enable this feature, you must tell Preside the hostname and port of your remote service. This can be acheived either using environment variables, or by setting directly in your Config.cfc:

// in Config.cfc
settings.clamav.remoteHostname = "clamav.svc.hostname"
settings.clamav.remotePort     = 3310;
settings.clamav.remoteTimeout  = 2000; // in milliseconds

# environment variables
CLAMAV_REMOTE_HOSTNAME=clamav.svc.hostname
CLAMAV_REMOTE_PORT=3310
CLAMAV_REMOTE_TIMEOUT=2000

See Injecting environment variables in the official Preside docs for details on how to do that.

Once these settings are detected, the ClamAV extension will run in "remote server" mode.