Move clean files Add-On

This add-on moves clean files into a target bucket. With this add-on, you can ensure that files are scanned before users can download them.

The ReportCleanFiles parameter of the bucketAV stack must be set to true (defaults to true). Learn how to configure bucketAV.


Table of Contents


Install Add-On

  1. Set the Stack name to bucketav-move-clean.
  2. Set the BucketAVStackName parameter to the stack name of bucketAV (if you followed our docs, the name is bucketav, or s3-virusscan for older installations).
  3. Set the TargetBucketName parameter to an existing S3 bucket where clean files are stored.
  4. Select I acknowledge that AWS CloudFormation might create IAM resources.
  5. Click on the Create stack button to save.

Target bucket in different AWS Account

If you have a multi-account setup, you might run the bucketAV in AWS account a while your target bucket is created in AWS account b.

Add the following bucket policy statements to your target S3 bucket in account b to grant bucketAV from account a access.

  • Replace ROLE_ARN with the MoveRoleArn output of the CloudFormation bucketav-move-clean stack from account a.
  • Replace BUCKET_NAME with the name of the target S3 bucket from account b.
  "Version": "2012-10-17",
  "Statement": [{
    "Sid": "bucketAVRequired1",
    "Effect": "Allow",
    "Principal": {
      "AWS": "ROLE_ARN"
    "Action": "s3:ListBucket*",
    "Resource": "arn:aws:s3:::BUCKET_NAME"
  }, {
    "Sid": "bucketAVRequired2",
    "Effect": "Allow",
    "Principal": {
      "AWS": "ROLE_ARN"
    "Action": "s3:PutObject*",
    "Resource": "arn:aws:s3:::BUCKET_NAME/*"


Which version am I using?

  1. To update this add-on to version v2.2.2, go to the AWS CloudFormation Management Console .
  2. Double-check the region at the top right.
  3. Search for bucketav-move-clean (or s3-virusscan-move-clean for older installations), otherwise search for the name you specified.
  4. Select the stack and click on Update.
  5. Select Replace current template and set the Amazon S3 URL to Copy
  6. Click on Next.
  7. Scroll to the bottom of the page and click on Next.
  8. Scroll to the bottom of the page and click on Next.
  9. Scroll to the bottom of the page, enable I acknowledge that AWS CloudFormation might create IAM resources, and click on Update stack.
  10. While the update runs, the stack status is UPDATE_IN_PROGRES. Reload the table from time to time and …
  11. … wait until the CloudFormation stack status switches to UPDATE_COMPLETE.


The following AWS services are used:

  • SNS Subscription to connect to the Findings Topic.
  • Lambda Function to move the clean files into the target S3 bucket.
  • CloudWatch Alarms to monitor the used AWS services.

Need more help?

Write us, and we'll get back to you as soon as we can.

Send us an email