Nextcloud Antivirus App

files_antivirus is an antivirus app for Nextcloud based on ClamAV.

Details

The idea is to check for virus at upload-time, notifying the user (on screen and/or email) and remove the file if it's infected.

QA metrics on master branch:

QA metrics on stable8 branch:

Status

The App is not complete yet, the following works/is done:

• It can be configured to work with the executable or the daemon mode of ClamAV
• If used in daemon mode it can connect through network- or local file-socket
• In daemon mode, it sends files to a remote/local server using INSTREAM command
• When the user uploads a file, it's checked
• If an uploaded file is infected, it's deleted and a notification is shown to the user on screen and an email is sent with details.
• Tested in Linux only
• Background Job to scan all files

In progress

• Test uploading from clients

ToDo

• File size limit
• Configurations Tuneups
• Other OS Testing
• Look for ideas :P

Requirements

• Nextcloud 10
• ClamAV (Binaries or a server running ClamAV in daemon mode)

Install

• Install and enable the App

• Make sure ClamAV is installed and running on your server.

  • (for example, in ubuntu 16.04)
    sudo apt-get update && sudo apt-get install -y clamav-daemon
sudo <dpkg-reconfigure clamav-freshclam

• choose an appropriate update server and the interval.

• Change to the apps directory in your NextCloud installation
  cd [path to nextcloud]/apps

• Download the app from GitHub. Use:
  https://github.com/nextcloud/files_antivirus/archive/stable10.zip3 for NextCloud 10
  https://github.com/nextcloud/files_antivirus/archive/old-master.zip for NextCloud 11
  https://github.com/nextcloud/files_antivirus/archive/stable12.zip for NextCloud 12
  https://github.com/nextcloud/files_antivirus/archive/master.zip11 for NextCloud 13
  [sudo] wget https://[link to the version you need]

• Unzip the file into your nextcloud/apps directory.
  [sudo] unzip [filename]

• Chown that folder to your web server user (www-data in Ubuntu and Debian)
  [sudo] chown -R www-data:www-data files_antivirus-master

• Rename the directory
  [sudo] mv files_antivirus-master files_antivirus

• Reload your vhosts (May or may not be necessary!)
  [sudo] service apache2 reload

• Log on to NextCloud and goto Apps. In the "Not enabled" section, enable "Antivirus App for files"

• Go to Admin Panel and configure the App

Authors:

Manuel Delgado López :: manuel.delgado at ucr.ac.cr
Bart Visscher