SAWS is hosted on PyPI. The following command will install SAWS along with dependencies such as the AWS CLI:
$ pip install saws
You can also install the latest SAWS from GitHub source which can contain changes not yet pushed to PyPI:
$ pip install git+https://github.com/donnemartin/saws.git
If you are not installing in a virtualenv, run:
$ sudo pip install saws
Once installed, start SAWS:
$ saws
It is recommended that you install Python packages in a virtualenv to avoid potential issues with dependencies or permissions.
If you are a Windows user or if you would like more details on virtualenv, check out this guide.
Install virtualenv and virtualenvwrapper, or check out the Pipsi Installation section below:
pip install virtualenv
pip install virtualenvwrapper
export WORKON_HOME=~/.virtualenvs
source /usr/local/bin/virtualenvwrapper.sh
Create a SAWS virtualenv and install SAWS:
mkvirtualenv saws
pip install saws
If you want to activate the saws virtualenv again later, run:
workon saws
Pipsi simplifies the virtualenv setup.
Install pipsi:
pip install pipsi
Create a virtualenv and install SAWS:
pipsi install saws
For Python 3:
pipsi install --python=python3 saws
Note: Pipsi might not be fully supported on Windows.
SAWS can be run from docker without additional dependencies. Assuming docker is installed and configured, the docker image can be built by running the following in a directory containing the Dockerfile:
docker build -t saws .
SAWS can then be run by:
docker run -it -e AWS_ACCESS_KEY_ID=<key> -e AWS_SECRET_ACCESS_KEY=<secret> -e AWS_DEFAULT_REGION=<region> saws
Or by mounting a local .aws configuration directory:
docker run -it -v path/to/.aws/:/root/.aws:ro saws
There is a known issue with Apple and its included python package dependencies (more info at pypa/pip#3165). We are investigating ways to fix this issue but in the meantime, to install saws, you can run:
$ sudo pip install saws --upgrade --ignore-installed six