Using the Snowball Client - AWS Snowball Edge Developer Guide

Using the Snowball Client

Following, you can find information about how to get and use the Snowball client with your AWS Snowball Edge device. The Snowball client is a standalone terminal application that you run on your local server to unlock the device and get credentials, logs, and status information. You can also use the client for administrative tasks for a cluster. While using the Snowball client, you can get additional support information by running the snowballEdge help command.

When you read and write data to the AWS Snowball Edge device, you use the Amazon S3 Adapter for Snowball or the file interface.


In January 2018, there was a feature update for clusters, making them leaderless. The cluster update is backward-compatible with older clusters. However, if you're looking for documentation for the original Snowball client for Snowball Edge, see Using the Snowball Client.

Downloading and Installing the Snowball Client

You can download and install the Snowball client from AWS Snowball resources.

You can download and install the Snowball client from AWS Snowball Edge Resources. On that page, you can find the installation package for your operating system. Follow the instructions to install the Snowball client. Running the Snowball client from a terminal in your workstation might require using a specific path, depending on your operating system:

  • Microsoft Windows – When the client has been installed, you can run it from any directory without any additional preparation.

  • Linux – The Snowball client must be run from the ~/snowball-client-linux-build_number/bin/ directory. The Snowball client is only supported on 64-bit Linux distributions.

  • macOS – The script copies folders from the Snowball client .tar file to the /usr/local/bin/snowball directory. If you run this script, you can then run the Snowball client from any directory if /usr/local/bin is a path in your bash_profile. You can verify your path using the echo $PATH command.