Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
79 lines (46 sloc) 1.79 KB

Local Setup

This section describes how to set up your local machine to use the STUPS tools.

In general you will need:

  • Python 3.4+
  • Docker 1.11+

Linux

Python 3 is usually already installed on Ubuntu. You will need the PIP package manager to install STUPS tools:

$ sudo apt-get install python3-pip

Install Docker on Ubuntu according to the Docker on Ubuntu installation instructions.

Install the aws-cli

$ sudo pip3 install --upgrade awscli

Check that everything works by running:

$ python3 --version  # should print Python 3.4.0 (or higher)
$ docker info        # should work without using sudo!

Mac

Local Environment

OS X users may need to set their locale environment to UTF-8:

# You can put these two commands in your local shell initialization script
# e.g. ~/.bashrc or ~/.zshrc
export LC_ALL=en_US.utf-8
export LANG=en_US.utf-8

Install Python and Docker

You can either use Homebrew or :ref:`local-setup-macports` to install Python 3.4 on Mac OS X.

Install Python 3 using Homebrew (pip3 already comes with this package)

$ brew install python3

Install Docker on Mac according to the Docker on Mac installation instructions, then install the aws commandline tool.

$ brew install awscli

Check that everything works by running:

$ python3 --version  # should print Python 3.4.0 (or higher)
$ docker info        # should work without using sudo!