Skip to main content

Encrypting command-line client for Amazon Glacier.

Project description


Encrypting command-line client for Amazon Glacier.

This command-line client lets you store files and directories in Amazon Glacier. All data is encrypted using GnuPG before being uploaded and no original filenames will be visible remotely.


  • AWS credentials with write access to Glacier
  • GnuPG public/private keypair


AWS credentials

Configure AWS credentials as described in the Boto documentation. The credentials should have write access to the Glacier vaults you plan to use. See the example IAM policy for recommended permissions.

GnuPG keypair

Create a keypair for icebox and make a note of the ID. Retrieval operations can take a long time, so you should make sure the keypair stays accessible, i.e. no password prompts blocking the operation.

Install icebox

Install icebox using pip (or pipsi):

pip install icebox


Create a new box

Create the box mybox for a Glacier vault called myvault like this:

icebox init mybox 0xMYKEYID glacier myvault

If your AWS credentials are not in the default profile, use the --profile option:

icebox init mybox 0xMYKEYID glacier myvault --profile icebox

Store data in a box

To store a file or directory, simply specify its location:

icebox put myvault cat-pictures/grumpy.jpg

Retrieve data from a box

There are no directories in boxes, so you just specify the original name of the source and a destination:

icebox get myvault grumpy.jpg ~/Desktop

Standard retrievals can take a long time. To perform an Expedited retrieval, use the Tier option:

icebox get myvault grumpy.jpg ~/Desktop -o Tier=Expedited

Retrieval operations are tracked by icebox, so you can interrupt a waiting retrieval and request the same source again later.

Project details

Download files

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

Source Distribution

icebox-0.1.0.tar.gz (8.3 kB view hashes)

Uploaded source

Built Distribution

icebox-0.1.0-py3-none-any.whl (23.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page