Installing, updating, and uninstalling the AWS CLI version 1 on Linux

To install the AWS CLI version 1 using the bundled installer

1. Download the AWS CLI version 1 bundled installer using one of the the following methods.

   • Download using the curl command.

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

     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.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 1.16.312 would be awscli-bundle-1.16.312.zip resulting in the following command:

     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"

   • Download using the direct link.

     For the latest version of the AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.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 1.16.312 would be awscli-bundle-1.16.312.zip resulting in the following url https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

2. Extract the files from the package. If you don't have unzip to extract the files, use your Linux distribution's built-in package manager to install it.

   $ unzip awscli-bundle.zip

3. Run the install program. The installer installs the AWS CLI at /usr/local/aws and creates the symlink aws at 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 entering aws from any directory.

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

   By default, the install script runs under the system default version of Python. If you have installed an alternative version of Python and want to use that version to install the AWS CLI, run the install script with that version by absolute path to the Python executable, as follows.

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

4. Verify that the AWS CLI installed correctly.

   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

   If you get an error, see Troubleshooting errors for the AWS CLI.

To install the AWS CLI version 1 for current user

1. Download the AWS CLI version 1 bundled installer in one of the following ways.

   • Download using the curl command.

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

     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.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 1.16.312 would be awscli-bundle-1.16.312.zip resulting in the following command:

     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"

   • Download using the direct link.

     For the latest version of the AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.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 1.16.312 would be awscli-bundle-1.16.312.zip resulting in the following url https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

2. Extract the files from the package by using unzip. If you don't have unzip, use your Linux distribution's built-in package manager to install it.

   $ unzip awscli-bundle.zip

3. Run the install program. The installer installs the AWS CLI at /usr/local/aws and creates the symlink aws at the /usr/local/bin directory. The command uses the -b parameter to specify the directory where the installer places the aws symlink file. You must have write permissions to the specified folder.

   $ ./awscli-bundle/install -b ~/bin/aws

   This installs the AWS CLI to the default location (~/.local/lib/aws) and creates a symbolic link (symlink) at ~/bin/aws. Make sure that ~/bin is in your PATH environment variable for the symlink to work.

   $ echo $PATH | grep ~/bin     // See if $PATH contains ~/bin (output will be empty if it doesn't)
   $ export PATH=~/bin:$PATH     // Add ~/bin to $PATH if necessary

4. Ensure the directory that the AWS CLI version 1 is part of your PATH variable.

   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 at the end of your profile script that's similar to the following example.

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

      This command inserts the path, ~/.local/bin in this example, at the front of the existing PATH variable.

   3. Reload the profile into your current session to put those changes into effect.

      $ source ~/.bash_profile

5. Verify that the AWS CLI installed correctly.

   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

   If you get an error, see Troubleshooting errors for the AWS CLI.

1. If you installed the AWS CLI using the bundled installer, follow these instructions. The bundled installer doesn't put anything outside of the installation directory except the optional symlink, so uninstalling is as simple as deleting those two items.

   $ sudo rm -rf /usr/local/aws
   $ sudo rm -rf /usr/local/bin/aws

2. (Optional) Remove the shared AWS SDK and AWS CLI settings information in the .aws folder.

   Warning

   These configuration and credentials settings are shared across all AWS SDKs and the AWS CLI. If you remove this folder, they cannot be accessed by any AWS SDKs that are still on your system.

   The default location of the .aws folder differs between platforms, by default the folder is located in ~/.aws/. If your user has write permission to this directory, you don't need to use sudo.

   $ sudo rm -r ~/.aws/

1. Use the curl command to download the installation script. The following command uses the -O (uppercase "O")parameter to specify that the downloaded file is to be stored in the current directory using the same name it has on the remote host.

   $ curl -O https://bootstrap.pypa.io/get-pip.py

2. Run the script with the python or python3 command to download and install the latest version of pip and other required support packages. When you include the --user switch, the script installs pip to the path ~/.local/bin.

   $ python3 get-pip.py --user

3. Ensure the directory that contains pip is part of your PATH variable.

   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 at the end of your profile script that's similar to the following example.

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

      This command inserts the path, ~/.local/bin in this example, at the front of the existing PATH variable.

   3. Reload the profile into your current session to put those changes into effect.

      $ source ~/.bash_profile

4. To verify that pip or pip3 is installed correctly, run the following command.

   $ pip3 --version
   pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)

1. Use the pip or pip3 command to install or update the AWS CLI. We recommend that if you use Python version 3 or later that you use the pip3 command. The --user switch, pip installs the AWS CLI to ~/.local/bin.

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

   $ pip3 install awscli --upgrade --user

   For a specific version of the AWS CLI, append two equals signs = and the version number to the filename. For this example the filename for version 1.16.312 would be ==1.16.312 resulting in the following command:

   $ pip3 install awscli==1.16.312 --upgrade --user

   Note

   Use appropriate quoting rules for your terminal. In order to use the = character, you might need to use single or double quotes to escape properly. The following example escapes using single quotes:

   $ pip3 install 'awscli==1.16.312' --upgrade --user

2. Verify that the AWS CLI installed correctly.

   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

   If you get an error, see Troubleshooting errors for the AWS CLI.

1. If you installed the AWS CLI version 1 using pip, you must also uninstall using pip.

   $ pip uninstall awscli

   If you are using version Python 2 or 3, you might need to use the pip2 or pip3 command. Use the aws --version command to determine the Python version associated with your installed AWS CLI version 1.

   $ pip3 uninstall awscli

   You might need to restart your command prompt window or your computer to remove all files.

2. (Optional) Remove the shared AWS SDK and AWS CLI settings information in the .aws folder.

   Warning

   These configuration and credentials settings are shared across all AWS SDKs and the AWS CLI. If you remove this folder, they cannot be accessed by any AWS SDKs that are still on your system.

   The default location of the .aws folder differs between platforms, by default the folder is located in ~/.aws/. If your user has write permission to this directory, you don't need to use sudo.

   $ sudo rm -r ~/.aws/

1. Install Snapcraft on your platform. For information on installing Snapcraft, see Installing the daemon in the Snap documentation.

2. Restart your system so that your PATH variables are updated correctly. If you are having installation issues, follow steps in Fix common issues in the Snap documentation.

3. To verify that snap is installed correctly, run the following command.

   $ snap version

1. Run the following snap install command for the AWS CLI version 1.

   $ snap install aws-cli --channel=v1/stable --classic

   Depending on your permissions, you may need to add sudo to your command.

   $ sudo snap install aws-cli --channel=v1/stable --classic

2. Verify that the AWS CLI installed correctly.

   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

   If you get an error, see Troubleshooting errors for the AWS CLI.

1. If you installed the AWS CLI version 1 using snap, you must also uninstall using snap.

   $ snap remove aws-cli

   You might need to restart your command prompt window or your computer to remove all files.

2. (Optional) Remove the shared AWS SDK and AWS CLI settings information in the .aws folder.

   Warning

   These configuration and credentials settings are shared across all AWS SDKs and the AWS CLI. If you remove this folder, they cannot be accessed by any AWS SDKs that are still on your system.

   The default location of the .aws folder differs between platforms, by default the folder is located in ~/.aws/. If you have write permissions to this directory, you don't need to use sudo.

   $ sudo rm -r ~/.aws/

To modify your PATH variable

1. Find your shell's profile script in your user directory. 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