Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Automatic backup management of AWS EC2 EBS volumes

Project description

Downloads Latest Version License

Automated EBS Snapshots helps you ensure that you have up to date snapshots of your EBS volumes.

All you need to do to get started is documented below.


pip install automated-ebs-snapshots

Authentication configuration

Automated EBS snapshots can be configured either via command line options or using a configuration file.

Command line options

You can use the following command line options to authenticate to AWS.

AWS configuration options:
  --access-key-id ACCESS_KEY_ID
                        AWS access key
  --secret-access-key SECRET_ACCESS_KEY
                        AWS secret access key
  --region REGION       AWS region

Configuration file

Create a configuration file anywhere on you file system.

access-key-id: xxxx
secret-access-key: xxxxxxxx
region: eu-west-1

Then use the --config command line option to point at your configuration file.

Watching and unwatching volumes

Start watching a volume

In order to enable automatic snapshots, you need to start watching the volume. The following command will add vol-13245678 to the watchlist with snapshots created daily.

automated-ebs-snapshots --config ~/auto-ebs-snapshots.conf --watch vol-12345678 --interval daily

Add volumes to watch list

To add lots of volumes in one time, we can create a configuration file to define volumes(support volume id or Name tag), interval and retention.


Then run the following command

automated-ebs-snapshots --config ~/auto-ebs-snapshots.conf --watch-file volumes.conf

List watched volumes

List the currently watched volumes and their backup interval

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --list

Stop watching a volume

To stop creating automated backups for a volume, run this:

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --unwatch vol-12345678

Remove volumes from watch list

To remove all volumes in the configuration file, just run:

automated-ebs-snapshots --config ~/auto-ebs-snapshots.conf --unwatch-file volumes.conf

List snapshots for a volume

List all snapshots for the given volume id or volume name

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --snapshots vol-d9d6d6af

Creating snapshots

Now, to start taking snapshots you will need to have Automated EBS Snapshots running. You can either run automated-ebs-snapshots manually (i.e. scheduled in crontab or such) or have it running in daemon mode.

Manual execution

Running automated-ebs-snapshots manually:

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --run

It will check if there are any volumes with no or too old snapshots. New snapshots will be created if needed.

Daemon mode

Start the daemon by running

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --daemon start

Stop the daemon with

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --daemon stop

You can also restart it using

automated-ebs-snapshots --config ~/automated-ebs-snapshots.conf --daemon restart

Release notes


  • Fix for logging incorrect region information when using instance role (#19). Thanks @robaman for the pull request


  • Added support for reading volumes from file (#13). Thanks @yumminhuang for the pull request
  • Now supports managing volumes by tag Name in addition to volume-id (#13). Thanks @yumminhuang for the pull request


  • Bumped requirement to boto >= 2.29.0 (#7)


  • Fixed IAM Instance Profile authentication for boto >= 2.29.0 (#6)


  • Print volume Name tag in –list (#3)
  • Support authentication using instance profiles (#5)
  • Only write logs to file if –log-file is specified (#2)


This project is maintained by Sebastian Dahlgren and it is supported by Skymill Solutions.


APACHE LICENSE 2.0 Copyright 2014 Skymill Solutions

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
automated-ebs-snapshots-0.4.1.tar.gz (21.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page