Like to learn visually? We got you covered.

All in one tutorial: Master set & forget scheduled S3 bucket backups in just 10 Minutes

Help topics


Aliases: How to create backup jobs for one or more AWS accounts

Enter your credentials to create an alias
Note: We do NOT store your alias/keypair information on our servers.
All keypairs are stored in encrypted format on your hard drive in the APPDATA folder for BucketBacker.

Creating your alias - what you need to know

Before you can create backup jobs for your S3 buckets you'll first need to create an alias.

An alias represents an AWS credentials keypair. An AWS keypair consists of the following:

  • Access Key
  • Secret Key

To create an alias follow these steps:

  1. Enter your access key
  2. Enter your secret key
  3. Click the "Create Alias" button

You will then need to password protect your alias

Password protect your alias

Note: We do NOT store alias, password or any other sensitive information on our servers.
All information pertaining to your credentials, passwords, aliases and backup jobs are stored on your computer in the BucketBacker APPDATA folder.
All sensitive information like secret keys and passwords are stored in encrypted format.

Once you create an alias BucketBacker will then be able to retrieve the buckets for that AWS keypair along with any backup jobs you may have created.

Reasons you may wish to create multiple aliases.

  • You wish to backup buckets for multiple AWS accounts
  • You wish to logically separate your backup jobs

Please note: You may wish to use AWS Identity and Access Management (IAM) for your alias' keypair.

Learn more about AWS Identity and Access Management

back to contents

Backup Jobs - What you need to know

Backup jobs consist of line items

  • Backup jobs consist of one or more line items.
  • Each line item represents a specific bucket you wish to back up.
  • Each backup job can contain up to 20 line items.
  • The job list allows you to Add, Rename or Delete a backup job.
  • Once a backup job is selected the "Line Item Wizard" allows you to add, edit or delete line items.

The job list lets you create, rename and delete jobs

The job list

Creating a new backup job workflow:

New job button

  • Create a new job using the "New" button
Name your new backup job

Rename/Delete a backup job workflow:

Edit job button

  • Rename or delete a backup job using the, "Edit" button
The "Edit" button displays a form to allow you to Rename or Delete a job

Please note that if you are renaming a backup job that has been previously scheduled in the Windows Task Scheduler you need to do three things:

  • Delete the old task with the old job name from the Windows Task Scheduler
  • In BucketBacker you must create a new scheduled job from the Schedule Backup Job wizard
  • Create a trigger for the new scheduled job in the Windows Task Scheduler (right-click the job and select properties)

Line Items: How to add buckets to your backup job

  • Select a backup job from the jobs list
The job list

At this point the "Line Item Wizard" is displayed.

The Line Item Wizard

For more information about the Line Item Wizard click the link below

Line Item Wizard - How to add buckets to your backup jobs

back to contents

Global Backup Bucket - What you need to know

  • The global backup bucket is a bucket dedicated to storing your backups
  • The global backup bucket applies to all backup jobs for a single alias.
  • The global backup bucket can store unlimited backups.

Global Bucket data entry form

Because AWS S3 has a hard limit of 100 buckets per account we have decided this is the best way to store your backups.
BucketBacker will copy your S3 objects to the global backup bucket in folder format with self-describing names

How backup jobs are named and stored in the global backup bucket

The folders stored here are self-descriptive based on the following paradigm:
Source bucket name + "-" + backup type
In the example below three line items are created to backup the bucket, "aaa_qa_snappy"
Each line item specifies a different backup type.

In this example the backup types selected are as follows

  • Cumulative
  • Synchronized
  • Snapshot

Thus the folder names containing your backups will become:

  • aaa_qa_snappy-cumulative
  • aaa_qa_snappy-synchronized
  • aaa_qa_snappy-snapshot
The "Destination" column lists the names of the folders containing your backed up objects

Your backups on S3 - Notice how the folders match the destination column

back to contents

AWS Bucket Naming Rules for the Global Backup Bucket

Visit the AWS website for up to the minute bucket naming rules

Rules for Bucket Naming

The following is excerpted directly from the AWS website.

We recommend that all bucket names comply with DNS naming conventions. These conventions are enforced in all regions except for the US Standard region.


If you use the AWS management console, bucket names must be DNS compliant in all regions.

DNS-compliant bucket names allow customers to benefit from new features and operational improvements, as well as providing support for virtual-host style access to buckets. While the US Standard region currently allows non-compliant DNS bucket naming, we are moving to the same DNS-compliant bucket naming convention for the US Standard region in the coming months. This will ensure a single, consistent naming approach for Amazon S3 buckets. The rules for DNS-compliant bucket names are:

  • Bucket names must be at least 3 and no more than 63 characters long.

  • Bucket names must be a series of one or more labels. Adjacent labels are separated by a single period (.). Bucket names can contain lowercase letters, numbers, and hyphens. Each label must start and end with a lowercase letter or a number.

  • Bucket names must not be formatted as an IP address (e.g.,

The following examples are valid bucket names:

  • myawsbucket


  • myawsbucket.1

The following examples are invalid bucket names:

Invalid Bucket NameComment
.myawsbucketBucket name cannot start with a period (.).
myawsbucket.Bucket name cannot end with a period (.).
my..examplebucketThere can be only one period between labels.

Challenges with Non–DNS-Compliant Bucket Names

The US Standard region currently allows more relaxed standards for bucket naming, which can result in a bucket name that is not DNS-compliant. For example,  MyAWSBucket is a valid bucket name, even though it contains uppercase letters. If you try to access this bucket by using a virtual-hosted–style request (, the URL resolves to the bucket myawsbucket and not the bucket  MyAWSBucket. In response, Amazon S3 will return a "bucket not found" error.

To avoid this problem, we recommend as a best practice that you always use DNS-compliant bucket names regardless of the region in which you create the bucket. For more information about virtual-hosted–style access to your buckets, see Virtual Hosting of Buckets.

The rules for bucket names in the US Standard region allow bucket names to be as long as 255 characters, and bucket names can contain any combination of uppercase letters, lowercase letters, numbers, periods (.), hyphens (-), and underscores (_).

back to contents

Line Item Wizard - What you need to know

Note: Once you master the Line Item Wizard the rest is child's play

Page 1 of the Line Item Wizard

Note: You should understand the following topics before reading this section

What is a line item?

  • A line item represents a single bucket that you wish to backup.
  • Backup jobs can contain one or more line items.
  • The Line Item Wizard makes adding line items to your backup jobs very easy

How does the Line Item Wizard work?

The Line Item Wizard has three pages

  • Page 1: Backup Job line items - View, add, edit and delete line items
  • Page 2: Configure Details - Select the line item source bucket and backup type
  • Page 3: Include/Exclude bucket folders

Creating a line item workflow

The easiest way to understand line items is to create one

In this example we are going to create a single line item to backup a single bucket.

  • We will backup a bucket named, "aaa_qa_snappy".
  • We will make the backup type: Synchronized
  • We will only backup one folder in the bucket named, "aaaaaaa2"

Step 1: Create a backup job and select it

Step 2 - Click the "New Line Item" button from the "Backup job line items" wizard page

Step 3 - Configure details (Select a bucket to backup and choose a backup type from the "Backup Type" dropdown)

Step 4 (Optional) - Include or exclude bucket folders from the backup job line item

  • Click the Save button

You have just created a new line item

Your new line item has been added to the Bucket Listing page of the wizard

The following documentation is available for the individual wizard pages

back to contents

Backup Types (Cumulative, Synchronized & Snapshot)

Use the "Backup Type" dropdown to define the type of backup for your line item

The three types of backups available to you

  • Cumulative
  • Synchronized
  • Snapshot

Each backup type explained

  • Cumulative

A cumulative backup will copy the latest version of any object to your backup folder.
If you delete an object in the source bucket it will NOT be deleted in the backup folder.
This means that your backup folder will have a copy of every file you've ever backed up.
This is contrasted with the "Synchronized" backup which will DELETE any object in the backup folder that is not found in the source bucket.

Note: This will be saved to your global backup bucket in the following format
<source_bucket>-cumulative as illustrated below where the source bucket is, "aaa_qa_snappy"
A cumulative backup in your global backup bucket

  • Synchronized

A synchronized backup will copy the latest version of any object to your backup folder.
It will also delete any object in your backup folder that was deleted from the source bucket.
This is ideal for when you wish to maintain a perfect copy of a bucket.
Note: This will be saved to your global backup bucket in the following format
<source_bucket>-synchronized as illustrated below where the source bucket is, "aaa_qa_snappy"

A synchronized backup in your global backup bucket

  • Snapshot

A snapshot backup will create a timestamped folder to keep a copy of the source bucket.
This is ideal when you want to take a picture in time of your bucket.
Note: This will be saved to your global backup bucket in the following format

Fig 1. A snapshot backup in your global backup bucket
Note: If you drill into the folder you will find subfolders that are timestamped as illustrated below
Fig 2. A nested timestamped folder is created for each snapshot

back to contents

Include/Exclude bucket folders (optional)

Use the "Include/Exclude" feature to limit your backup to only certain folders

The difference between "Include" and "Exclude explained"

  • Include

If you only wish to back up specific folders you will want to select the "Include" option

  • Only the folders you select for inclusion will be backed up
  • If you also wish to backup root level objects for the bucket be sure to check the, "Include root level files" checkbox as illustrated below.
Fig. 1. Include root level files checkbox

  • Exclude

If you only wish to exclude certain folders you will want to select the "Exclude" option

  • Everything BUT the folder(s) you exclude will be backed up

Pro-tips: How to know which one to choose

Exclude candidate: If you have folders in your buckets that fall into the following categories you may wish to EXCLUDE them from backups

  • Folders already backed with an extremely large number of objects
  • Folders already backed up whose contents never change

By excluding these types of folders your backups run faster and you save money

Include candidate: If you have folders in your buckets that meet the following criteria

  • Only a few folders change frequently
  • Only a few folders need frequent snapshots

By including these types of folders your backups run faster and you save money

Real world examples


We have certain buckets containing folders with JSON files that never change. These objects number in the hundreds of thousands.

However, we still wish to backup the non-static objects in these buckets frequently. We run cumulative, synchronized and snapshot backups for these buckets and we exclude our folders containing the hundreds of thousands of JSON files that never change and are already backed up.


We have certain buckets containing folders used to run static websites. These files rarely change so less frequent backups are appropriate.

However, some of these buckets have folders containing user generated data that changes constantly and we wish to back those folders up frequently.

In this case we run cumulative, synchronized and snapshot backups just for those folders.

back to contents

Run/Schedule backup jobs

The Run/Schedule Backup Job's wizard

Manually run a backup job

How to manually run or schedule your backup jobs

To instantly test your backup jobs simply click the, "Manually Run Backup Job Now" button as illustrated below.

Fig. 1. Manually run your backup job button

Windows® Scheduler Automated Backup Jobs

Windows Task Scheduler documentation
The Windows Task Scheduler with Task Scheduler Library open to BucketBacker folder

How to create Set & Forget scheduled backup jobs

Question: When do I create scheduled jobs?

Answer: Anytime after you create a new backup job you can use the Create/Overwrite Scheduled Job button to create a new task in the Windows Task Scheduler

Please note: Normally, you only have to create a scheduled job once. As soon as you have scheduled your job as a task in the Windows Task Scheduler any line item changes you make to the backup job will automatically take effect the next time the backup job runs with two exceptions noted below:


  1. If you are a subscriber to the Email Notification Service and wish to change the email address for a previously scheduled job you will have to recreate the scheduled job and add a new trigger.
  2. If you rename a backup job you will have to recreate the scheduled job and add a new trigger.

To instantly schedule backup jobs simply click the, "Create/Overwrite Scheduled Job" button in the ""Run/Schedule Backup Job" wizard as illustrated below.

Fig. 2a. The Run/Schedule backup jobs wizard

Fig. 2b. Create/Overwrite Scheduled Job button

Clicking this button will automatically create a task in the Windows® Task Scheduler.

All BucketBacker backup job tasks are placed in a folder called, "BucketBacker" in the "Task Scheduler Libary" as illustrated below.

Fig. 3. Task Scheduler Library's "BucketBacker" folder

Your job will appear in the tasks list and will be named using the following convention:

  • BucketBacker-<Jobname>
Fig. 4. Task Scheduler Library's "BucketBacker" folder job list

Configuring the task to run on schedule:

  • Right-click the task and select "Properties"
Fig. 5. Task shortcut menu

Next you will need to make changes to the following tabs of the "Properties" window.

  1. General
  2. Triggers
  3. Settings
  • Select the "General" tab

    1. Select, "Run whether user is logged on or not"
    2. Check, "Run with highest privileges"
Fig. 5A. "General" tab of the task properties wizard

  • Select the "Triggers" tab

Fig. 6. "Triggers" tab of the task properties wizard

  • Click the "New..." button of the "Triggers" tab
Fig. 7. Triggers tab of the task properties wizard

  • Configure the "New Trigger" form
Fig. 8. Configuring a new trigger for your backup task

  • Save the trigger
Fig. 9. After saving the trigger your backup job is now scheduled!

  • Select the "Settings" tab

    • Change the dropdown FROM
      • Do not start a new instance
    • TO
      • Stop the existing instance
Fig. 11. Required to prevent computer password changes from causing your scheduled tasks to stop running.
Note: This has nothing to do with BucketBacker password changes. This refers to password changes on your computer/server itself.

By selecting, "Stop the existing instance" from the dropdown in Fig. 11. you enable your tasks to automatically adapt to password changes on your computer.

Fig. 12. Please ensure that your "Settings" tab dropdown looks just like the illustration below

  • Click the OK button of the Properties Wizard to finalize your settings
Fig. 10. After clicking the OK button of the task properties wizard

Congratulations! You have now created a Set & Forget BucketBacker backup job.

back to contents

Email Notification Service Premium Subscription

This premium service is available free during your two week trial period.

To use this feature simply enter an email address in Step 1.

Fig. 1. Step 1 of the Run/Schedule backup jobs wizard
Fig. 2. The Run/Schedule backup jobs wizard allows you to add a notification email

Each schedule backup job can notify a different email address

Please note: The email notification address is assigned on a job by job basis.

If you wish to change the notification email address for a pre-existing scheduled job you will need to perform the following steps.

  • Re-create the scheduled task by clicking the, "Create/Overwrite Scheduled Job" button
  • Re-create the trigger for the scheduled task in Windows Task Scheduler

For more information about creating schedule tasks and triggers please view the following topic: Scheduled Backups

Email Notification Service - Benefits of a premium subscription

  • Peace of mind: every time a backup job runs you will receive a completed job notification straight to your inbox
  • Error Reporting: If your backup job encounters any errors (e.g. detection of corrupt S3 objects, missing bucket, connectivity issues) you will receive an error notification
  • Archiving: completed job notifications will be archived in the AppData logs next to their XML counterparts
  • Insight: completed job notifications are highly detailed and help you ensure that your jobs are both properly configured and running without issue

View sample completed job notification as a web page

Fig. 3. A completed job notification delivered right to your inbox

A word about Email Notification Service security

We do not store your job notifications on our servers after they are emailed.
All job notifications are immediately deleted from our servers after they are successfully emailed to you.

back to contents

BucketBacker scaling and resource allocation

BucketBacker is a multithreaded application, capable of running unlimited backup jobs simultaneously and in parallel.

This feature may overload your hardware resources and throughput (internet connection) if you do not carefully consider the load on your computer and verify your resources are sufficient for the successful completion of your backup jobs.

It is your responsibility to ensure that BucketBacker is installed on a machine (including virtual machines) capable of handling the load you intend to place upon it.

To illustrate an overload scenario:

You have 200 buckets with one million objects in each - If you attempt to create 200 backup jobs and run them simultaneously on a computer with insufficient RAM, CPU cores and available internet throughput, you will DEFINITELY overload your hardware and internet connection. At this point BucketBacker will begin to malfunction and write errors to your log files.

It is your responsibility to intelligently provision your scheduled backup jobs to avoid over-utilizing your resources as there is a direct correlation between the capacity of your resources (bandwidth/throughput, CPU cores and RAM) and your ability to run multiple large backup jobs simultaneously.

It is your responsibility to test your scheduled backup jobs to ensure that you are not overloading your resources. BucketBacker writes completion and error log files in XML format to your APPDATA folder, allowing detailed analysis of backup job status. It is your responsibility to review your log files to ensure backup jobs ran as intended.

BucketBacker also offers a premium email notification service that proactively pushes your log files, in HTML format, directly to your inbox.

BucketBacker © MultiTask123 LLC. All rights reserved.