Install the AWS CLI on Windows
- Install the AWS CLI Using the MSI Installer
- Install the AWS CLI Using Python and pip on Windows
- Add the AWS CLI Executable to Your Command Line Path
Install the AWS CLI Using the 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. To update frequently, consider using pip for easier updates.
To install the AWS CLI using the MSI installer
- Download the appropriate MSI installer.
- Download the AWS CLI MSI installer for Windows (64-bit)
- Download the AWS CLI MSI installer for Windows (32-bit)
- Download the AWS CLI setup file (includes both the 32-bit and 64-bit MSI installers and will automatically install the correct version)
- Run the downloaded MSI installer or the setup file.
- Follow the onscreen instructions.
By default, the CLI installs to
C:\Program Files\Amazon\AWSCLI (64-bit version) or
C:\Program Files (x86)\Amazon\AWSCLI (32-bit version). To confirm the installation, use the
aws --version command at a command prompt (open the Start menu and search for
cmd to start a command prompt).
C:\> aws --version aws-cli/1.16.116 Python/3.6.8 Windows/10 botocore/1.12.106
Don’t include the prompt symbol (
C:\>, shown 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 program, you might need to close and reopen the command prompt to refresh the path, or add the installation directory to your PATH environment variable manually.
Updating an MSI Installation
The AWS CLI is updated regularly. Check 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 described previously.
Uninstalling the AWS CLI
To uninstall the AWS CLI, open the Control Panel, and then choose Programs and Features. Select the entry named AWS Command Line Interface, and then choose Uninstall to launch the uninstaller. Confirm that you want to uninstall the AWS CLI when you’re prompted.
You can also launch the Programs and Features program from the command line with the following command.
Install the AWS CLI Using Python and
pip on Windows
The Python Software Foundation provides installers for Windows that include
To install Python and
- Download the Python Windows x86-64 installer from the downloads page of Python.org.
- Run the installer.
- Choose Add Python 3 to PATH.
- Choose Install Now.
The installer installs Python in your user folder and adds its program folders to your user path.
To install the AWS CLI with
If you use Python version 3+, we recommend that you use the
- Open the Command Prompt from the Start menu.
- Use the following commands to verify that Python and
pipare both installed correctly.
python --versionPython 3.7.1 C:\>
pip3 --versionpip 18.1 from c:\program files\python37\lib\site-packages\pip (python 3.7)
- Install the AWS CLI using
pip3 install awscli
- Verify that the AWS CLI is installed correctly.
aws --versionaws-cli/1.16.116 Python/3.6.8 Windows/10 botocore/1.12.106
To upgrade to the latest version, run the installation command again.
C:\> pip3 install --user --upgrade awscli
Add the AWS CLI Executable to Your Command Line Path
After installing the AWS CLI with
pip, add the
aws program to your operating system’s
PATH environment variable. With an MSI installation, this should happen automatically, but you might need to set it manually if the
aws command doesn’t run after you install it.
You can find where the aws program is installed by running the following command.
C:\> where aws C:\Program Files\Python37\Scripts\aws
If that command does not return any results, then you must add the path manually. Use the command line or Windows Explorer to discover where it is installed on your computer. Typical paths include:
- Python 3 and
- Python 3 and
pip3–user option on earlier versions of Windows –
- Python 3 and
pip3–user option on Windows 10 –
- MSI installer (64-bit) –
- MSI installer (32-bit) –
C:\Program Files (x86)\Amazon\AWSCLI
Folder names that include version numbers can vary. The examples above show Python37. Replace as needed with the version number you are using.
To modify your PATH variable (Windows)
- Press the Windows key and enter
- Choose Edit environment variables for your account.
- Choose PATH, and then choose Edit.
- Add the path to the Variable value field. For example:
- Choose OK twice to apply the new settings.
- Close any running command prompts and reopen the command prompt window