Stable release

To install amazon-dash, run these commands in your terminal:

$ sudo pip3 install -U amazon_dash
$ sudo python3 -m amazon_dash.install

This is the preferred method to install amazon-dash, as it will always install the most recent stable release. You must execute both commands in the correct order. Amazon-dash also works with Python2:

$ sudo pip2 install -U amazon_dash
$ sudo python2 -m amazon_dash.install

If you don’t have pip installed, this Python installation guide can guide you through the process.

Other releases

You can install other versions from Pypi using:

$ pip install amazon-dash==<version>
$ sudo python -m amazon_dash.install

For versions that are not in Pypi (it is a development version):

$ pip install git+<branch>#egg=amazon-dash
$ sudo python -m amazon_dash.install

If you do not have git installed:

$ pip install<branch>.zip $ sudo python -m amazon_dash.install

Distro packages

Arch Linux

If you use Arch Linux or an Arch Linux derivative, you can install Amazon Dash from AUR. For example if you use yaourt:

$ yaourt -S amazon-dash-git


There is support for FreeNAS created by Troy Prelog:

wget -O /tmp/amazon-dash.json
sudo iocage fetch -P dhcp=on vnet=on bpf=yes -n /tmp/amazon-dash.json --branch 'master'

Installation Issues

There are many Linux distributions available and not all are tested. If you think there is a bug please open a issue. Before opening a issue, check the following:

# Search similar issues. #. Your Python version (check the supported versions). #. Upgrade pip and setuptools (pip install -U setuptools pip). #. Check if it is a configuration error. Errors that start with [Error] Amazon Dash Exception are usually not bugs. #. Finally, follow the guidelines for creating issues.

From sources

The sources for amazon-dash can be downloaded from the Github repo.

You can either clone the public repository:

$ git clone git://

Or download the tarball:

$ curl  -OL

Once you have a copy of the source, you can install it with:

$ python install
$ sudo python -m amazon_dash.install

Other OS that Linux

At the moment only Linux is officially supported by the Amazon-dash project. However Amazon-dash should work on unix-like systems. Microsoft Windows is not supported and it is unknown if it works. Please do not open issues requesting support for Windows, I have no chance to try Amazon-dash on Windows.


The configuration file must use these permissions:

chmod 600 <config file>
chown root <config file>

OS X is not officially supported. But I’ve read that it works without problems.