How to install the Azure CLI

The Azure CLI is available to install in Windows, macOS and Linux environments. It can also be run in a Docker container and Azure Cloud Shell.

Install

The current version of the Azure CLI is 2.58.0. For information about the latest release, see the release notes. To find your installed version and see if you need to update, run az version.

Note

If you're using the Azure classic deployment model, install the Azure classic CLI.

FAQ

Where is the Azure CLI installed?

When installing the Azure CLI, you can't select an install location. In Windows, the 32-bit Azure CLI installs in C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2 and the 64-bit in C:\Program Files\Microsoft SDKs\Azure\CLI2. In Linux, the Azure CLI is installed in /opt/az/ on Ubuntu and Debian, and in /lib64/az/ on CentOS, RHEL and Azure Linux.

User-specific configuration files are located in $HOME/.azure on macOS and Linux, and %USERPROFILE%\.azure on Windows. These locations are known as the AZURE_CONFIG_DIR.

What version of the Azure CLI is installed?

Type az version in a terminal window to know what version of the Azure CLI is installed. Your output looks like this:

{
  "azure-cli": "x.xx.0x",
  "azure-cli-core": "x.xx.x",
  "azure-cli-telemetry": "x.x.x",
  "extensions": {}
}

What extensions are installed?

Use the az extension list command to see installed extension. You can also use az version, but az extension list provides additional information including the installation path and status. For information on managing extensions, see Use and manage extensions with the Azure CLI.

See also