Menu
AWS Command Line Interface
User Guide

Install the AWS Command Line Interface on Microsoft Windows

You can install the AWS CLI on Windows with a standalone installer or pip, a package manager for Python. If you already have pip, follow the instructions in the main installation topic.

MSI Installer

The AWS CLI is supported on Microsoft Windows XP or later. For Windows users, the MSI installation package offers a familiar and convenient way to install the AWS CLI without installing any other prerequisites.

When updates are released, you must repeat the installation process to get the latest version of the AWS CLI. If you prefer to update frequently, consider using pip for easier updates.

To install the AWS CLI using the MSI installer

  1. Download the appropriate MSI installer.

    Note

    The MSI installer for the AWS CLI does not work with Windows Server 2008 (version 6.0.6002). Use pip to install with this version of Windows.

  2. Run the downloaded MSI installer.

  3. Follow the instructions that appear.

The CLI installs to C:\Program Files\Amazon\AWSCLI (64-bit) or C:\Program Files (x86)\Amazon\AWSCLI (32-bit) by default. To confirm the installation, use the aws --version command at a command prompt (open the START menu and search for "cmd" if you're not sure where the command prompt is installed).

Copy
> aws --version aws-cli/1.11.44 Python/3.4.3 Windows/7 botocore/1.5.7

Don't include the prompt symbol ('>' above) when you type a command. These are included in program listings to differentiate commands that you type from output returned by the CLI. The rest of this guide uses the generic prompt symbol '$' except in cases where a command is Windows-specific.

If Windows is unable to find the executable, you may need to re-open the command prompt or add the installation directory to your PATH environment variable manually.

Updating an MSI Installation

The AWS CLI is updated regularly. Check out the Releases page on GitHub to see when the latest version was released. To update to the latest version, download and run the MSI installer again as detailed above.

Uninstalling

To uninstall the AWS CLI, open the Control Panel and select Programs and Features. Select the entry named AWS Command Line Interface and click Uninstall to launch the uninstaller. Confirm that you wish to uninstall the AWS CLI when prompted.

You can also launch the Programs and Features menu from the command line with the following command:

Copy
> appwiz.cpl

Install Python, pip, and the AWS CLI on Windows

The Python Software Foundation provides installers for Windows that include pip.

To install Python 3.4 and pip (Windows)

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

  2. Add the Python home and scripts directories to the Windows Path system variable:

    Copy
    C:\WINDOWS\system32;C:\WINDOWS;C:\Python34;C:\Python34\Scripts;%USERPROFILE%\AppData\Roaming\Python\Scripts

To modify your PATH variable (Windows)

  1. Press the Windows key and type environment variables.

  2. Choose Edit environment variables for your account.

  3. Choose PATH and then choose Edit.

  4. Add paths to the Variable value field, separated by semicolons. For example: C:\existing\path;C:\new\path

  5. Choose OK twice to apply the new settings.

  6. Close any running command prompts and re-open.

To install the AWS CLI with pip (Windows)

  1. Open the Windows Command Processor from the Start menu.

  2. Verify that Python and pip are both installed correctly with the following commands:

    Copy
    C:\Windows\System32> python --version Python 3.4.3 C:\Windows\System32> pip --version pip 6.0.8 from C:\Python34\lib\site-packages (python 3.4)
  3. Install the AWS CLI using pip:

    Copy
    C:\Windows\System32> pip install --upgrade --user awscli
  4. Verify that the AWS CLI is installed correctly:

    Copy
    C:\Windows\System32> aws --version aws-cli/1.11.44 Python/3.4.3 Windows/7 botocore/1.5.7

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

Copy
C:\Windows\System32> pip install --user --upgrade awscli

Adding the AWS CLI Executable to your Command Line Path

After installing with pip, add the aws executable to your OS's PATH environment variable. With an MSI installation, this should happen automatically, but you may need to set it manually if the aws command is not working.

  • Python 3.4 and pip (user mode)%USERPROFILE%\AppData\Roaming\Python\Scripts

  • Python 3.5+ and pip (user mode)%USERPROFILE%\AppData\Roaming\Python\Python35\Scripts

  • MSI installer (64-bit)C:\Program Files\Amazon\AWSCLI

  • MSI installer (32-bit)C:\Program Files (x86)\Amazon\AWSCLI

To modify your PATH variable (Windows)

  1. Press the Windows key and type environment variables.

  2. Choose Edit environment variables for your account.

  3. Choose PATH and then choose Edit.

  4. Add paths to the Variable value field, separated by semicolons. For example: C:\existing\path;C:\new\path

  5. Choose OK twice to apply the new settings.

  6. Close any running command prompts and re-open.