Prerequisites

AWS CloudShell is a browser-based, pre-authenticated shell that you can launch directly from the AWS Management Console. You can run AWS CLI commands against AWS services using your preferred shell (Bash, PowerShell, or Z shell). And you can do this without needing to download or install command line tools. If you are working out of one of these Regions: US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Tokyo), or Europe (Ireland), using AWS CloudShell is the simplest option.

To launch AWS CloudShell:

• From the AWS Management Console, you can launch AWS CloudShell by choosing the following options available on the navigation bar:

  • Choose the AWS CloudShell icon.

  • Start typing “cloudshell” in the Search box and then choose the CloudShell option.

  When AWS CloudShell launches in a new browser window for the first time, a welcome panel displays and lists key features. After you close this panel, status updates are provided while the shell configures and forwards your console credentials. When the command prompt displays, the shell is ready for interaction.

• To choose an AWS Region to work in, go to the Select a Region menu and select a supported AWS Region to work in. (Available Regions are highlighted.)

Prerequisites

You must have Docker installed. For installation instructions, see the Docker website

To verify your installation of Docker, run the following command and confirm there is an output.

$ docker --version
Docker version 19.03.1

Run the official AWS CLI version 2 Docker image

The official AWS CLI version 2 Docker image is hosted on DockerHub in the amazon/aws-cli repository. The first time you use the docker run command, the latest Docker image is downloaded to your computer. Each subsequent use of the docker run command runs from your local copy.

To run the AWS CLI version 2 Docker image, use the docker run command.

$ docker run --rm -it amazon/aws-cli <command>

This is how the command functions:

• docker run --rm --it amazon/aws-cli – The equivalent of the aws executable. Each time you run this command, Docker spins up a container of your downloaded amazon/aws-cli image, and executes your aws command. By default, the Docker image uses the latest version of the AWS CLI version 2.

  For example, to call the aws --version command in Docker, you run the following.

  $ docker run --rm -it amazon/aws-cli --version
  aws-cli/2.1.22 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.0.0dev10
  

• --rm – Specifies to clean up the container after the command exits.

• -it – Specifies to open a pseudo-TTY with stdin. This enables you to provide input to the AWS CLI version 2 while it’s running in a container, for example, by using the aws configure and aws help commands. If you are running scripts, -it is not needed. If you are experiencing errors with your scripts, omit -it from your Docker call.

For more information about the docker run command, see the Docker reference guide

Update to the latest Docker image

Because the latest Docker image is downloaded to your computer only the first time you use the docker run command, you need to manually pull an updated image. To manually update to the latest version, we recommend you pull the latest tagged image. Pulling the Docker image downloads the latest version to your computer.

$ docker pull amazon/aws-cli:latest

Prerequisites

• You must be able to extract or “unzip” the downloaded package. If your operating system doesn’t have the built-in unzip command, use an equivalent.

• The AWS CLI version 2 uses glibc, groff, and less. These are included by default in most major distributions of Linux.

• We support the AWS CLI version 2 on 64-bit versions of recent distributions of CentOS, Fedora, Ubuntu, Amazon Linux 1, and Amazon Linux 2.

• Because AWS doesn’t maintain third-party repositories, we can’t guarantee that they contain the latest version of the AWS CLI.

Install the AWS CLI version 2 on Linux

Follow these steps from the command line to install the AWS CLI

For the latest version of the AWS CLI, use the following command block:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

For a specific version of the AWS CLI, append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be awscli-exe-linux-x86_64-2.0.30.zip resulting in the following command:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

For a list of versions, see the AWS CLI version 2 changelog on GitHub.

Update the AWS CLI version 2 on Linux

To update your copy of the AWS CLI version 2, from the Linux command line, follow these steps.

1. Download the installation file in one of the following ways:

   • Using the curl command – The options on the following example command write the downloaded file to the current directory with the local name awscliv2.zip.

     The -o option specifies the file name that the downloaded package is written to. In this example, the file is written to awscliv2.zip in the current directory.

     For the latest version of the AWS CLI, use the following command block:

     $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
     

     For a specific version of the AWS CLI, append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be awscli-exe-linux-x86_64-2.0.30.zip resulting in the following command:

     $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
     

     For a list of versions, see the AWS CLI version 2 changelog .

   • Downloading from the URL – To download the installer using your browser, use one of the following URLs. You can verify the integrity and authenticity of the installation file after you download it. For more information before you unzip the package, see Verify the integrity and authenticity of the downloaded installer files .

     For the latest version of the AWS CLI: https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip

     For a specific version of the AWS CLI: Append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be awscli-exe-linux-x86_64-2.0.30.zip resulting in the following link https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip. For a list of versions, see the AWS CLI version 2 changelog on GitHub.

2. Unzip the installer. If your Linux distribution doesn’t have a built-in unzip command, use an equivalent to install it. The following example command unzips the package and creates a directory named aws under the current directory.

   $ unzip awscliv2.zip
   

3. To ensure that the update installs in the same location as your current AWS CLI version 2, locate the existing symlink and installation directory.

   • Use the which command to find your symlink. This will then display the path to use with the --bin-dir parameter.

     $ which aws
     /usr/local/bin/aws
     

   • Use the ls -l command against the value returned above to find the directory that your symlink points to. This will display the path to use with the --install-dir parameter.

     $ ls -l /usr/local/bin/aws
     lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
     

4. Use your symlink and installer information to construct the install command with the --update parameter.

   $ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
   

5. Confirm the installation.

   $ aws --version
   aws-cli/2.1.24 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.0.0
   

Prerequisites

• You must be able to extract or “unzip” the downloaded package. If your operating system doesn’t have the built-in unzip command, use an equivalent.

• The AWS CLI version 2 uses glibc, groff, and less. These are included by default in most major distributions of Linux.

• We support the AWS CLI version 2 on 64-bit Linux ARM.

• Because AWS doesn’t maintain third-party repositories, we can’t guarantee that they contain the latest version of the AWS CLI.

Install the AWS CLI version 2 on Linux ARM

For the latest version of the AWS CLI, use the following command block:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

For a specific version of the AWS CLI, append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be awscli-exe-linux-x86_64-2.0.30.zip resulting in the following command:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

Update the AWS CLI version 2 on Linux

To update your copy of the AWS CLI version 2, from the Linux command line, follow these steps.

1. Download the installation file in one of the following ways:

   • Using the curl command – The options on the following example command write the downloaded file to the current directory with the local name awscliv2.zip.

     The -o option specifies the file name that the downloaded package is written to. In this example, the file is written to awscliv2.zip in the current directory.

     For the latest version of the AWS CLI, use the following command block:

     $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
     

     For a specific version of the AWS CLI, append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be awscli-exe-linux-x86_64-2.0.30.zip resulting in the following command:

     $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
     

     For a list of versions, see the AWS CLI version 2 changelog .

   • Downloading from the URL – To download the installer using your browser, use one of the following URLs. You can verify the integrity and authenticity of the installation file after you download it. For more information before you unzip the package, see Verify the integrity and authenticity of the downloaded installer files .

     For the latest version of the AWS CLI: https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

     For a specific version of the AWS CLI: Append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be awscli-exe-linux-x86_64-2.0.30.zip resulting in the following link https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip. For a list of versions, see the AWS CLI version 2 changelog on GitHub.

2. Unzip the installer. If your Linux distribution doesn’t have a built-in unzip command, use an equivalent to install it. The following example command unzips the package and creates a directory named aws under the current directory.

   $ unzip awscliv2.zip
   

3. To ensure that the update installs in the same location as your current AWS CLI version 2, locate the existing symlink and installation directory.

   • Use the which command to find your symlink. This will then display the path to use with the --bin-dir parameter.

     $ which aws
     /usr/local/bin/aws
     

   • Use the ls -l command against the value returned above to find the directory that your symlink points to. This will display the path to use with the --install-dir parameter.

     $ ls -l /usr/local/bin/aws
     lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
     

4. Use your symlink and installer information to construct the install command with the --update parameter.

   $ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
   

5. Confirm the installation.

   $ aws --version
   aws-cli/2.1.24 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.0.0
   

Prerequisites

• We support the AWS CLI version 2 on Apple-supported versions of 64-bit macOS.

• Because AWS doesn’t maintain third-party repositories, we can’t guarantee that they contain the latest version of the AWS CLI.

Install and update the AWS CLI version 2 using the macOS user interface

The following steps show how to install or update to the latest version of the AWS CLI version 2 by using the standard macOS user interface and your browser. If you are updating to the latest version, use the same installation method that you used for your current version.

1. In your browser, download the macOS pkg file:

   • For the latest version of the AWS CLI: https://awscli.amazonaws.com/AWSCLIV2.pkg

   • For a specific version of the AWS CLI: Append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be AWSCLIV2-2.0.30.pkg resulting in the following link https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg. For a list of versions, see the AWS CLI version 2 changelog on GitHub .

2. Double-click the downloaded file to launch the installer.

3. Follow the on-screen instructions. You can choose to install the AWS CLI version 2 in the following ways:

   • For all users on the computer (requires sudo)

     • You can install to any folder, or choose the recommended default folder of /usr/local/aws-cli.

     • The installer automatically creates a symlink at /usr/local/bin/aws that links to the main program in the installation folder you chose.

   • For only the current user (doesn’t require sudo)

     • You can install to any folder to which you have write permission.

     • Due to standard user permissions, after the installer finishes, you must manually create a symlink file in your $PATH that points to the aws and aws_completer programs by using the following commands at the command prompt. If your $PATH includes a folder you can write to, you can run the following command without sudo if you specify that folder as the target’s path. If you don’t have a writable folder in your $PATH, you must use sudo in the commands to get permissions to write to the specified target folder. The default location for a symlink is /usr/local/bin/.

     $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
     $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
     

Install and update the AWS CLI version 2 for all users using the macOS command line

You can download, install, and update from the command line. If you are updating to the latest version, use the same installation method that you used in your current version. You can install the AWS CLI version 2.

For the latest version of the AWS CLI, use the following command block:

$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /

For a specific version of the AWS CLI, append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be AWSCLIV2-2.0.30.pkg resulting in the following command:

$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /

Install and update the AWS CLI version 2 for only the current user using the macOS command line

1. To specify which folder the AWS CLI is installed to, you must create an XML file. This file is an XML-formatted file that looks like the following example. Leave all values as shown, except you must replace the path /Users/myusername in line 9 with the path to the folder you want the AWS CLI version 2 installed to. The folder must already exist, or the command fails. This XML example specifies that the installer installs the AWS CLI in the folder /Users/myusername, where it creates a folder named aws-cli.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
     <array>
       <dict>
         <key>choiceAttribute</key>
         <string>customLocation</string>
         <key>attributeSetting</key>
         <string>/Users/myusername</string>
         <key>choiceIdentifier</key>
         <string>default</string>
       </dict>
     </array>
   </plist>
   

2. Download the pkg installer using the curl command. The -o option specifies the file name that the downloaded package is written to. In this example, the file is written to AWSCLIV2.pkg in the current folder.

3. For the latest version of the AWS CLI, use the following command block:

   $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
   

   For a specific version of the AWS CLI, append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be AWSCLIV2-2.0.30.pkg resulting in the following command:

   $ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
   

   For a list of versions, see the AWS CLI version 2 changelog on GitHub .

4. Run the standard macOS installer program with the following options:

   • Specify the name of the package to install by using the -pkg parameter.

   • Specify a current user only installation by setting the parameter --target CurrentUserHomeDirectory.

   • Specify the path (relative to the current folder) and name of the XML file that you created in the --applyChoiceChangesXML parameter

   The following example installs the AWS CLI in the folder /Users/myusername/aws-cli.

   $ installer -pkg AWSCLIV2.pkg \
               -target CurrentUserHomeDirectory \
               -applyChoiceChangesXML choices.xml
   

5. Because standard user permissions typically don’t allow writing to folders in your $PATH, the installer in this mode doesn’t try to add the symlinks to the aws and aws_completer programs. For the AWS CLI to run correctly, you must manually create the symlinks after the installer finishes. If your $PATH includes a folder you can write to and you specify the folder as the target’s path, you can run the following command without sudo. If you don’t have a writable folder in your $PATH, you must use sudo for permissions to write to the specified target folder. The default location for a symlink is /usr/local/bin/.

   $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
   $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
   

   After installation is complete, debug logs are written to /var/log/install.log.

Verify the installation

To verify that the shell can find and run the aws command in your $PATH, use the following commands.

$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.1.24 Python/3.7.4 Darwin/18.7.0 botocore/2.0.0

Prerequisites

Before you can install or update the AWS CLI version 2 on Windows, be sure you have the following:

• A 64-bit version of Windows XP or later

• Admin rights to install software

Install or update the AWS CLI version 2 on Windows using the MSI installer

1. Download the AWS CLI MSI installer for Windows (64-bit):

   • For the latest version of the AWS CLI: https://awscli.amazonaws.com/AWSCLIV2.msi

   • For a specific version of the AWS CLI: Append a hyphen and the version number to the filename. For this example the filename for version 2.0.30 would be AWSCLIV2-2.0.30.msi resulting in the following link https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi. For a list of versions, see the AWS CLI version 2 changelog on GitHub .

   To update your current installation of AWS CLI version 2 on Windows, download a new installer each time you update to overwrite previous versions. AWS CLI is updated regularly. To see when the latest version was released, see the AWS CLI version 2 changelog on GitHub .

2. Run the downloaded MSI installer and follow the on-screen instructions. By default, the AWS CLI installs to C:\Program Files\Amazon\AWSCLIV2.

3. To confirm the installation, open the Start menu, search for cmd to open a command prompt window, and at the command prompt use the aws --version command.

   Don’t include the prompt symbol (C:\>) when you type a command. These are included in program listings to differentiate commands that you type from output returned by the AWS CLI.

   C:\> aws --version
   aws-cli/2.1.24 Python/3.7.4 Windows/10 botocore/2.0.0
   

   If Windows is unable to find the program, you might need to close and reopen the command prompt window to refresh the path, or add the installation directory to your PATH environment variable manually.