Building and installing the Amazon CLI from source

$ ./configure --help

PS C:\> C:\msys64\usr\bin\bash -lc "./configure --help" 

The following command example uses the --prefix option to do a local user install of the Amazon CLI. This command installs the Amazon CLI in $HOME/.local/lib/aws-cli and the executables in $HOME/.local/bin:

$ ./configure --prefix=$HOME/.local

The following command example uses the --libdir option to install the Amazon CLI as an add-on application in the /opt directory. This command installs the Amazon CLI at /opt/aws-cli and the executables at their default location of /usr/local/bin.

$ ./configure --libdir=/opt

The following command example uses the --prefix option to do a local user install of the Amazon CLI. This command installs the Amazon CLI in $HOME/.local/lib/aws-cli and the executables in $HOME/.local/bin:

$ C:\msys64\usr\bin\bash -lc "./configure --prefix='C:\Program Files\AWSCLI'" 

The following command example uses the --libdir option to install the Amazon CLI as an add-on application in the /opt directory. This command installs the Amazon CLI at C:\Program Files\AWSCLI\opt\aws-cli.

$ PYTHON=/path/to/python ./configure

PS C:\> C:\msys64\usr\bin\bash -lc "PYTHON='C:\path\to\python' ./configure"

$ ./configure 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

PS C:\> C:\msys64\usr\bin\bash -lc "./configure" 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

$ ./configure --with-download-deps

PS C:\> C:\msys64\usr\bin\bash -lc "./configure --with-download-deps"

$ ./configure --with-install-type=portable-exe

PS C:\> C:\msys64\usr\bin\bash -lc "./configure --with-install-type=portable-exe"

$ make

PS C:\> C:\msys64\usr\bin\bash -lc "make"

The following command example installs the Amazon CLI using your configuration and build settings:

$ make install

The following command example installs the Amazon CLI using your configuration and build settings, then adds an environment variable with the path for the Amazon CLI:

PS C:\> C:\msys64\usr\bin\bash -lc " make install "
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"

The following code example uses a --prefix=/usr/local flag for configuring an install location, and then alters that destination using DESTDIR=/tmp/stage for the make install command. These commands result in the Amazon CLI being installed at /tmp/stage/usr/local/lib/aws-cli and its executables located in /tmp/stage/usr/local/bin.

$ ./configure --prefix=/usr/local
$ make
$ make DESTDIR=/tmp/stage install

The following code example uses a --prefix=\awscli flag for configuring an install location, and then alters that destination using DESTDIR=C:\Program Files for the make install command. These commands result in the Amazon CLI being installed at C:\Program Files\awscli.

$ ./configure --prefix=\awscli
$ make
$ make DESTDIR='C:\Program Files' install

Download the awscli.tar.gz file, extract, and install the Amazon CLI. When using the following commands, replace the following paths:

The following code example automates building and installing the Amazon CLI from PowerShell using MSYS2, and specifies which local install of Python to use:

PS C:\> curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscliv2.zip"  #  Download the awscli.tar.gz file in the current working directory
PS C:\> tar -xvzf .\awscli.tar.gz #  Extract awscli.tar.gz file
PS C:\> cd .\awscli-2.x.x\ #  Navigate to the root of the extracted files
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 source-sandbox/AMD64

Download the awscli.tar.gz file, extract, and install the Amazon CLI. When using the following commands, replace the following paths:

The following code example automates building and installing the Amazon CLI from PowerShell using MSYS2, and specifies which local install of Python to use:

PS C:\> cd C:path\to\cli\repository\
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version