Uninstall the Amazon CLI version 2 - Amazon Command Line Interface
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Uninstall the Amazon CLI version 2

This topic describes how to uninstall the Amazon Command Line Interface version 2 (Amazon CLI version 2).

Amazon CLI version 2 uninstallation instructions:

To uninstall the Amazon CLI version 2, run the following commands.

  1. Locate the symlink and install paths.

    • Use the which command to find the symlink. This shows the path you used with the --bin-dir parameter.

      $ which aws /usr/local/bin/aws
    • Use the ls command to find the directory that the symlink points to. This gives you the path you used 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
  2. Delete the two symlinks in the --bin-dir directory. If your user has write permission to these directories, you don't need to use sudo.

    $ sudo rm /usr/local/bin/aws $ sudo rm /usr/local/bin/aws_completer
  3. Delete the --install-dir directory. If your user has write permission to this directory, you don't need to use sudo.

    $ sudo rm -rf /usr/local/aws-cli
  4. (Optional) Remove the shared Amazon SDK and Amazon CLI settings information in the .aws folder.

    Warning

    These configuration and credentials settings are shared across all Amazon SDKs and the Amazon CLI. If you remove this folder, they cannot be accessed by any Amazon 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 -rf ~/.aws/

To uninstall the Amazon CLI version 2, run the following commands, substituting the paths you used to install. The example commands use the default installation paths.

  1. Find the folder that contains the symlinks to the main program and the completer.

    $ which aws /usr/local/bin/aws
  2. Using that information, run the following command to find the installation folder that the symlinks point to.

    $ 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/aws
  3. Delete the two symlinks in the first folder. If your user already has write permission to these folders, you don't need to use sudo.

    $ sudo rm /usr/local/bin/aws $ sudo rm /usr/local/bin/aws_completer
  4. Delete the main installation folder. Use sudo to gain write access to the /usr/local folder.

    $ sudo rm -rf /usr/local/aws-cli
  5. (Optional) Remove the shared Amazon SDK and Amazon CLI settings information in the .aws folder.

    Warning

    These configuration and credentials settings are shared across all Amazon SDKs and the Amazon CLI. If you remove this folder, they cannot be accessed by any Amazon 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 -rf ~/.aws/
  1. Open Programs and Features by doing one of the following:

    • Open the Control Panel, and then choose Programs and Features.

    • Open a command prompt, and then enter the following command.

      C:\> appwiz.cpl
  2. Select the entry named Amazon Command Line Interface, and then choose Uninstall to launch the uninstaller.

  3. Confirm that you want to uninstall the Amazon CLI.

  4. (Optional) Remove the shared Amazon SDK and Amazon CLI settings information in the .aws folder.

    Warning

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

    The default location of the .aws folder differs between platforms, by default the folder is located in %UserProfile%\.aws.

    $ rmdir %UserProfile%\.aws

Troubleshooting Amazon CLI install and uninstall errors

If you come across issues after installing or uninstalling the Amazon CLI, see Troubleshoot Amazon CLI errors for troubleshooting steps. For the most relevant troubleshooting steps, see Command not found errors, The "aws --version" command returns a different version than you installed, and The "aws --version" command returns a version after uninstalling the Amazon CLI.