Install Avast - Revision history

Stoiko Ivanov: add instruction to disable upstream reporting

2023-07-13T09:38:39Z

add instruction to disable upstream reporting

← Older revision		Revision as of 09:38, 13 July 2023
Line 62:		Line 62:
	systemctl restart pmg-smtp-filter		systemctl restart pmg-smtp-filter


			== Disable sending statistics and files to the Avast Virus Lab ==

			By default <code>avast</code> sends files it considers suspicious and statistics to the Avast's virus lab.
			To disable this you need to edit the avast configuration <code>/etc/avast/avast.conf</code>:

			# Avast configuration file
			#
			# Below are all available configuration options and their default values. Only
			# the options in the OPTIONS section can be changed at runtime.

			# RUN_DIR = "/run/avast"
			# TEMP_DIR = "/tmp"
			# DATA_DIR = "/var/lib/avast"
			# SOCKET = "/run/avast/scan.sock"
			# LICENSE = "/etc/avast/license.avastlic"
			# WHITELIST = "/etc/avast/whitelist"
			SUBMIT = "/bin/true"

			[OPTIONS]
			# CREDENTIALS = 0
			STATISTICS = 0
			HEURISTICS = 0
			# STREAMING_UPDATES = 1
			# REPUTATION_QUERIES = 1

			[PACKER_BOMB]
			# MAX_FILE_SIZE_TO_EXTRACT_MB = 1000
			# MAX_COMPRESSION_RATIO = 100

	Should you need further help, consider getting a [https://www.proxmox.com/en/proxmox-mail-gateway/pricing enterprise support subscription]		Should you need further help, consider getting a [https://www.proxmox.com/en/proxmox-mail-gateway/pricing enterprise support subscription]

Stoiko Ivanov: updated to bookworm repository and new changes in avast

2023-07-13T09:11:35Z

updated to bookworm repository and new changes in avast

← Older revision		Revision as of 09:11, 13 July 2023
Line 24:		Line 24:

	# Create the appropriate [https://manpages.debian.org/apt/sources.list.5.en.html sources.list] entry:		# Create the appropriate [https://manpages.debian.org/apt/sources.list.5.en.html sources.list] entry:
	#:<code>echo "deb https://repo.avcdn.net/linux-av/deb debian-~~bullseye~~ release" > /etc/apt/sources.list.d/avast.list</code>		#:<code>echo "deb https://repo.avcdn.net/linux-av/deb debian-bookworm release" > /etc/apt/sources.list.d/avast.list</code>
	# Verify the signing key for the repository from Avast:		# Verify the signing key for the repository from Avast:
	#* Get the key		#* Get the key
Line 41:		Line 41:

	Follow the [https://repo.avcdn.net/linux-av/doc/avast-techdoc.pdf instructions provided by Avast] to activate your purchased license.		Follow the [https://repo.avcdn.net/linux-av/doc/avast-techdoc.pdf instructions provided by Avast] to activate your purchased license.
	Currently (27.06.~~2022~~) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:		Currently (13.07.2023) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:
	avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>		avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>

			The utility is in a debian package of its own (so you can also run it on a separate machine):
			apt install avast-license

	After enabling your license you need to restart the <code>avast.service</code>		After enabling your license you need to restart the <code>avast.service</code>

Stoiko Ivanov: update date of last command verification

2022-06-27T11:00:21Z

update date of last command verification

← Older revision		Revision as of 11:00, 27 June 2022
Line 41:		Line 41:

	Follow the [https://repo.avcdn.net/linux-av/doc/avast-techdoc.pdf instructions provided by Avast] to activate your purchased license.		Follow the [https://repo.avcdn.net/linux-av/doc/avast-techdoc.pdf instructions provided by Avast] to activate your purchased license.
	Currently (02.07.~~2021~~) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:		Currently (27.06.2022) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:
	avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>		avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>

Stoiko Ivanov at 11:26, 20 April 2022

2022-04-20T11:26:10Z

← Older revision		Revision as of 11:26, 20 April 2022
Line 24:		Line 24:

	# Create the appropriate [https://manpages.debian.org/apt/sources.list.5.en.html sources.list] entry:		# Create the appropriate [https://manpages.debian.org/apt/sources.list.5.en.html sources.list] entry:
	#:<code>echo "deb ~~http~~://~~deb~~.~~avast~~.~~com~~/~~lin~~/~~repo~~ debian-~~buster~~ release" > /etc/apt/sources.list.d/avast.list</code>		#:<code>echo "deb https://repo.avcdn.net/linux-av/deb debian-bullseye release" > /etc/apt/sources.list.d/avast.list</code>
	# Verify the signing key for the repository from Avast:		# Verify the signing key for the repository from Avast:
	#* Get the key		#* Get the key

Stoiko Ivanov: update to bullseye instructions

2022-04-15T14:59:36Z

update to bullseye instructions

← Older revision		Revision as of 14:59, 15 April 2022
Line 6:		Line 6:

	For these setups Proxmox Mail Gateway offers an integration with the [https://www.avast.com/en-us/business/products/antivirus-for-linux Avast Antivirus for Linux].		For these setups Proxmox Mail Gateway offers an integration with the [https://www.avast.com/en-us/business/products/antivirus-for-linux Avast Antivirus for Linux].
			This HOWTO follows the technical documentation from Avast - https://repo.avcdn.net/linux-av/doc/avast-techdoc.pdf

	Avast Antivirus for Linux is commercial software and you will need to purchase a license in order to use it.		Avast Antivirus for Linux is commercial software and you will need to purchase a license in order to use it.
Line 26:		Line 27:
	# Verify the signing key for the repository from Avast:		# Verify the signing key for the repository from Avast:
	#* Get the key		#* Get the key
	#*:<code>wget https://~~files~~.~~avast~~.~~com~~/~~files~~/~~resellers/linux~~/avast.~~gpg~~</code>		#*:<code>wget https://repo.avcdn.net/linux-av/doc/avast-gpg-key.asc</code>
	#*Read the checksum		#*Read the checksum
	#*:<code>sha512sum avast.gpg</code>		#*:<code>sha512sum avast-gpg-key.asc</code>
	#* The result should be		#* The result should be
			#*:<code>7fca6e2a8984931d46a8ff13cd086a934ca126068c074c86a13a30aa2f909663b9e5ae8529a02632c7735d2823bfc71b0e0987a63f8c4dd11130b2529e956f22 avast-gpg-key.asc</code>
	#*:<code>d9bb45d67664ad86f8d91a8f98657554b0550a8e467a5d6a3132de5d214b072470bf793ced9e3f13f774b5bfd061ce0ce7b192bf450bb68fc988072af17fb229 avast.gpg</code>
	#* Add the GPG key		#* Add the GPG key
	#*:<code>~~apt~~-key ~~add avast~~.gpg</code>		#*:<code>cp avast-gpg-key.asc /etc/apt/trusted.gpg.d/</code>
	# Update the apt package information and install the software		# Update the apt package information and install the software
	#:<code>apt update</code>		#:<code>apt update</code>
Line 39:		Line 40:
	== Registering license ==		== Registering license ==

	Follow the [https://~~deb~~.~~avast~~.~~com~~/~~lin~~/doc/techdoc.pdf instructions provided by Avast] to activate your purchased license.		Follow the [https://repo.avcdn.net/linux-av/doc/avast-techdoc.pdf instructions provided by Avast] to activate your purchased license.
	Currently (02.07.2021) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:		Currently (02.07.2021) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:
	avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>		avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>

Stoiko Ivanov: /* Registering license */

2021-11-26T08:44:27Z

Registering license

← Older revision		Revision as of 08:44, 26 November 2021
Line 41:		Line 41:
	Follow the [https://deb.avast.com/lin/doc/techdoc.pdf instructions provided by Avast] to activate your purchased license.		Follow the [https://deb.avast.com/lin/doc/techdoc.pdf instructions provided by Avast] to activate your purchased license.
	Currently (02.07.2021) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:		Currently (02.07.2021) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:
	avastlic -f /etc/avast/license.~~avast~~ -c <YOUR-ACTIVATION-CODE>		avastlic -f /etc/avast/license.avastlic -c <YOUR-ACTIVATION-CODE>

	After enabling your license you need to restart the <code>avast.service</code>		After enabling your license you need to restart the <code>avast.service</code>

Stoiko Ivanov: /* Registering license */

2021-07-02T07:57:44Z

Registering license

← Older revision		Revision as of 07:57, 2 July 2021
Line 39:		Line 39:
	== Registering license ==		== Registering license ==

	Follow the [https://~~support~~.avast.com/~~en-eu~~/~~article/131~~/ instructions provided by Avast] to activate your purchased license.		Follow the [https://deb.avast.com/lin/doc/techdoc.pdf instructions provided by Avast] to activate your purchased license.
			Currently (02.07.2021) you'll get an activation code with your purchase and need to obtain the license file with the <code>avastlic</code> utility:
			avastlic -f /etc/avast/license.avast -c <YOUR-ACTIVATION-CODE>

	After enabling your license you need to restart the <code>avast.service</code>		After enabling your license you need to restart the <code>avast.service</code>

Martin: page created

2020-06-03T11:21:09Z

page created

New page

== Introduction ==

Proxmox Mail Gateway ships and uses the open source [https://www.clamav.net/ ClamAV] antivirus engine in its default installation.

Certain environments have the need for a better virus detection rate than the one achieved by ClamAV.

For these setups Proxmox Mail Gateway offers an integration with the [https://www.avast.com/en-us/business/products/antivirus-for-linux Avast Antivirus for Linux].

Avast Antivirus for Linux is commercial software and you will need to purchase a license in order to use it.

The following facts are why it can be integrated with Proxmox Mail Gateway as an alternative to ClamAV:

* The licensing is based on the number of installations instead of other licensing schemes such as the number of processed mails or mailboxes.
* The software runs daemonized and thus reads and caches the AV definitions once upon startup instead of each time a file is scanned

The following HOWTO provides the necessary steps to install and configure Avast within a Proxmox Mail Gateway installation.

== Installing Avast Antivirus for Linux ==

Proxmox Mail Gateway is based on Debian GNU/Linux - thus you need to follow the installation instruction for Debian systems.

To configure the Avast repository and install the software:

# Create the appropriate [https://manpages.debian.org/apt/sources.list.5.en.html sources.list] entry:
#:<code>echo "deb http://deb.avast.com/lin/repo debian-buster release" > /etc/apt/sources.list.d/avast.list</code>
# Verify the signing key for the repository from Avast:
#* Get the key
#*:<code>wget https://files.avast.com/files/resellers/linux/avast.gpg</code>
#*Read the checksum
#*:<code>sha512sum avast.gpg</code>
#* The result should be
#*:<code>d9bb45d67664ad86f8d91a8f98657554b0550a8e467a5d6a3132de5d214b072470bf793ced9e3f13f774b5bfd061ce0ce7b192bf450bb68fc988072af17fb229 avast.gpg</code>
#* Add the GPG key
#*:<code>apt-key add avast.gpg</code>
# Update the apt package information and install the software
#:<code>apt update</code>
#:<code>apt install avast</code>

== Registering license ==

Follow the [https://support.avast.com/en-eu/article/131/ instructions provided by Avast] to activate your purchased license.

After enabling your license you need to restart the <code>avast.service</code>
systemctl restart avast.service

== Integration with Proxmox Mail Gateway ==

Enabling the Avast scanner in Proxmox Mail Gateway is achieved by editing the [https://pmg.proxmox.com/pmg-docs/pmg-admin-guide.html#pmg_configuration_file Promox Mail Gateway's configuration file]
<code>/etc/pmg/pmg.conf</code> and adding the line <code>avast 1</code> to the <code>admin</code> section:

section: admin
avast 1
email admin@pmg.example

Finally you need to restart the <code>pmg-smtp-filter</code> service, or reboot your Promox Mail Gateway:
systemctl restart pmg-smtp-filter

Should you need further help, consider getting a [https://www.proxmox.com/en/proxmox-mail-gateway/pricing enterprise support subscription]