Role Detail

geerlingguy.clamav

ClamAV installation and configuration.
Downloads
507
Type Ansible
Minimum Ansible Version 2.2
Installation $ ansible-galaxy install geerlingguy.clamav
Tags
antimalware
antivirus
cloud
networking
scan
security
Last Commit 2017-08-03 22:12:10 PM UTC
Last Imported 2017-11-13 19:09:07 PM UTC
Version History
Version Release Date
1.2.2 2017-08-03 22:12:10 PM
1.2.1 2017-08-03 19:10:07 PM
1.2.0 2017-08-03 18:35:06 PM
1.1.0 2017-07-31 20:42:08 PM
1.0.0 2017-07-31 19:13:07 PM
Supported Platforms
Platform Version
Debian jessie
Debian stretch
EL 6
EL 7
Ubuntu trusty
Ubuntu xenial
Last 10 Imports
Completed Status
2017-11-13 19:09:07 PM UTC SUCCESS
2017-11-06 19:07:07 PM UTC SUCCESS
2017-10-30 20:45:08 PM UTC SUCCESS
2017-10-23 19:07:07 PM UTC SUCCESS
2017-10-16 19:20:07 PM UTC SUCCESS
2017-10-16 19:16:07 PM UTC FAILED
2017-10-09 19:10:07 PM UTC SUCCESS
2017-10-02 19:06:07 PM UTC SUCCESS
2017-09-25 19:04:07 PM UTC SUCCESS
2017-09-18 19:29:07 PM UTC SUCCESS

Ansible Role: ClamAV

Build Status

Installs ClamAV on RedHat/CentOS and Debian/Ubuntu Linux servers.

Requirements

None.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

clamav_packages:
  - clamav
  - clamav-base
  - clamav-daemon

(Defaults for Debian/Ubuntu shown). List of packages to be installed for ClamAV operations.

clamav_daemon_localsocket: /var/run/clamav/clamd.ctl
clamav_daemon_config_path: /etc/clamav/clamd.conf

Path configuration for ClamAV daemon. These are hardcoded specifically for each OS family (Debian and Red Hat) and cannot be overidden.

clamav_daemon_configuration_changes:
  - regexp: '^.*Example$'
    state: absent
  - regexp: '^.*LocalSocket .*$'
    line: 'LocalSocket {{ clamav_daemon_localsocket }}'

Changes to make to the configuration file that is read from when ClamAV starts. You need to at least comment the 'Example' line and open a LocalSocket (or TCPSocket, e.g. 3310 by default) to get the ClamAV daemon to run.

clamav_daemon_state: started
clamav_daemon_enabled: yes

Control whether the clamav-daemon service is running and/or enabled on system boot.

clamav_freshclam_daemon_state: started
clamav_freshclam_daemon_enabled: yes

Control whether the clamav-freshclam service is running and/or enabled on system boot.

Dependencies

None.

Example Playbook

- hosts: servers
  sudo: yes
  roles:
    - geerlingguy.clamav

License

MIT / BSD

Author Information

This role was created in 2017 by Jeff Geerling, author of Ansible for DevOps.

None