AWS Command Line Interface
User Guide

Install the AWS CLI on macOS

The recommended way to install the AWS Command Line Interface (AWS CLI) on macOS is to use the bundled installer. The bundled installer includes all dependencies and you can use it offline.

Important

The bundled installer doesn't support installing to paths that contain spaces.

Prerequisites

  • Python 2 version 2.6.5+ or Python 3 version 3.3+

Check your Python installation.

$ python --version

If your computer doesn't already have Python installed, or if you want to install a different version of Python, follow the procedure in Install the AWS CLI on Linux.

Install the AWS CLI Using the Bundled Installer

Follow these steps from the command line to install the AWS CLI using the bundled installer.

To install the AWS CLI using the bundled installer

  1. Download the AWS CLI Bundled Installer.

    $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
  2. Unzip the package.

    $ unzip awscli-bundle.zip

    Note

    If you don't have unzip, use your favorite package manager to install it or an equivalent.

  3. Run the install program.

    $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

    Note

    By default, the install script runs under the system's default version of Python. If you have installed an alternative version of Python and want to use that to install the AWS CLI, run the install script and specify that version by including the absolute path to the Python application. For example:

    $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

This command installs the AWS CLI to /usr/local/aws and creates the symlink aws in the /usr/local/bin directory. Using the -b option to create a symlink eliminates the need to specify the install directory in the user's $PATH variable. This should enable all users to call the AWS CLI by typing aws from any directory.

To see an explanation of the -i and -b options, use the -h option.

$ ./awscli-bundle/install -h

Here are the commands summarized for easy cut and paste at the command line.

curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Install the AWS CLI on macOS Using pip

You can also use pip directly to install the AWS CLI. If you don't have pip, follow the instructions in the main installation topic. Run pip3 --version to see if your version of macOS already includes Python and pip3.

$ pip3 --version

To install the AWS CLI on macOS

  1. Download and install the latest version of Python from the downloads page of Python.org.

  2. Download and run the pip3 installation script provided by the Python Packaging Authority.

    $ curl -O https://bootstrap.pypa.io/get-pip.py $ python3 get-pip.py --user
  3. Use your newly installed pip3 to install the AWS CLI. We recommend that if you use Python version 3+, that you use the pip3 command.

    $ pip3 install awscli --upgrade --user
  4. Verify that the AWS CLI is installed correctly.

    $ aws --version AWS CLI 1.16.116 (Python 3.6.8)

    If the program isn't found, add it to your command line path.

To upgrade to the latest version, run the installation command again.

$ pip3 install awscli --upgrade --user

Add the AWS CLI Executable to Your macOS Command Line Path

After installing with pip, you might need to add the aws program to your operating system's PATH environment variable. The location of the program depends on where Python is installed.

Example AWS CLI install location - macOS with Python 3.6 and pip (user mode)

~/Library/Python/3.7/bin

Substitute the version of Python that you have for the version in the example above.

If you don't know where Python is installed, run which python.

$ which python /usr/local/bin/python

The output might be the path to a symlink, not the actual program. Run ls -al to see where it points.

$ ls -al /usr/local/bin/python ~/Library/Python/3.7/bin/python3.6

pip installs programs in the same folder that contains the Python application. Add this folder to your PATH variable.

To modify your PATH variable (Linux, macOS, or Unix)

  1. Find your shell's profile script in your user folder. If you're not sure which shell you have, run echo $SHELL.

    $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
    • Bash.bash_profile, .profile, or .bash_login

    • Zsh.zshrc

    • Tcsh.tcshrc, .cshrc, or .login

  2. Add an export command to your profile script.

    export PATH=~/.local/bin:$PATH

    This command adds a path, ~/.local/bin in this example, to the current PATH variable.

  3. Load the updated profile into your current session.

    $ source ~/.bash_profile