Replacing version 1 with version 2 Side-by-side install

Installing Amazon CLI version 2 from Amazon CLI version 1

This topic provides instructions for migrating from Amazon CLI version 1 to Amazon CLI version 2.

Amazon CLI versions 1 and 2 use the same aws command name. If you have both versions installed, your computer uses the first one found in your search path. If you previously installed Amazon CLI version 1, we recommend that you do one of the following to use Amazon CLI version 2:

Recommended – Uninstall Amazon CLI version 1 and use only Amazon CLI version 2.
To have both version installed, use your operating system's ability to create a symbolic link (symlink) or alias with a different name for one of the two aws commands.

For information on breaking changes between version 1 and version 2, see New features and changes in the Amazon CLI version 2.

Replacing version 1 with version 2

Perform the following steps to replace Amazon CLI version 1 with Amazon CLI version 2.

To replace Amazon CLI version 1 with Amazon CLI version 2

Prepare any existing scripts you have for the migration by confirming any breaking changes between version 1 and version 2 in New features and changes in the Amazon CLI version 2.
Uninstall the Amazon CLI version 1 by following the uninstall instructions for your operating system in Installing, updating, and uninstalling the Amazon CLI version 1.
Confirm that the Amazon CLI is completely uninstalled by using the following command.
```
$ aws --version
```
Complete one of the following based on the output:
- No version returned: You've successfully uninstalled the Amazon CLI version 1 and can proceed to the next step.
- A version is returned: You still have an install of the Amazon CLI version 1. For troubleshooting steps, see The "aws --version" command returns a version after uninstalling the Amazon CLI. Perform troubleshooting steps until no version output is received.
Install the Amazon CLI version 2 by following the appropriate install instructions for your operating system in Installing or updating to the latest version of the Amazon CLI.

Side-by-side install

To have both versions installed, use your operating system's ability to create a symbolic link (symlink) or alias with a different name for one of the two aws commands.

Install the Amazon CLI version 2 by following the appropriate install instructions for your operating system in Installing or updating to the latest version of the Amazon CLI.
Use your operating system's ability to create a symlink or alias with a different name for one of the two aws commands, such as using aws2 for Amazon CLI version 2. The following are symlink examples for Amazon CLI version 2. Replace the PATH with your install location.
Linux and macOS
You can use a symbolic link or alias on Linux and macOS.
```
$ alias aws2='PATH'
```
Windows command prompt
DOSKEY on Windows.
```
C:\> doskey aws2=PATH
```

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

New features and changes

Uninstall