Install Azure CLI - Microsoft Docs

Overview

The Azure Command-Line Interface (Azure CLI) is a powerful tool for managing Azure resources directly from your command line. It's available for Windows, macOS, and Linux. Follow the instructions below to install the Azure CLI on your system.

Why Use the Azure CLI?

Automate Azure deployments and management tasks.
Integrate Azure management into your scripts and CI/CD pipelines.
Access a wide range of Azure services.
Work efficiently with familiar command-line tools.

Choose Your Operating System

Select your operating system to find the specific installation instructions:

Windows

You can install the Azure CLI on Windows using several methods. The recommended method for most users is the MSI installer.

Download the Installer: Visit the official Azure CLI installation page for Windows and download the latest MSI installer.
Run the Installer: Double-click the downloaded MSI file and follow the on-screen prompts. The installer will add the Azure CLI to your system's PATH.
Verify Installation: Open a new Command Prompt or PowerShell window and run:
```
az --version
```
If the installation was successful, you will see the Azure CLI version information.

Alternatively, you can use winget:

winget install --id Microsoft.AzureCLI -e

macOS

The easiest way to install the Azure CLI on macOS is by using Homebrew.

Install Homebrew (if not already installed): Open your Terminal and run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install Azure CLI: Once Homebrew is installed, run:
```
brew update && brew install azure-cli
```
Verify Installation: In your Terminal, run:
```
az --version
```
This command should display the installed Azure CLI version.

For other installation methods on macOS, please refer to the official documentation.

Linux

Installation on Linux varies by distribution. Here are instructions for common distributions using package managers.

Debian/Ubuntu

Install necessary packages:

sudo apt-get update
sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg

Download and install the Microsoft signing key:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/packages.microsoft.gpg > /dev/null

Add the Azure CLI repository:

echo "deb [arch=amd64,armhf,arm64 signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/azure-cli.list

Update and install Azure CLI:

sudo apt-get update
sudo apt-get install azure-cli

Fedora/CentOS/RHEL

Install Azure CLI using DNF/YUM:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
echo -e "[azure-cli]\nname=Azure CLI\nbaseurl=https://packages.microsoft.com/yumrepos/azure-cli\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo

sudo dnf install azure-cli

(Or use yum install azure-cli for older versions)

Verify Installation (All Linux Distributions)

Open your Terminal and run:

az --version

For detailed instructions for other Linux distributions, see the official Linux installation guide.

Docker

You can run the Azure CLI within a Docker container. This is useful for consistent environments or for scenarios where you don't want to install it directly on your host machine.

Pull the latest Azure CLI image:
```
docker pull mcr.microsoft.com/azure-cli
```

Run Azure CLI commands: To run a command, use the following format:

docker run -it --rm mcr.microsoft.com/azure-cli <your_az_command>

For example, to check the version:

docker run -it --rm mcr.microsoft.com/azure-cli az --version

Interactive Session: To start an interactive shell within the container:
```
docker run -it mcr.microsoft.com/azure-cli
```
You can then run az commands directly within this shell.

Learn more about using Azure CLI with Docker in the official Docker guide.

After Installation

Once the Azure CLI is installed, you can log in to your Azure account using:

az login

This command will open a web browser for you to authenticate. After successful authentication, you can start using az commands to manage your Azure resources.

Explore the Azure CLI command reference for a comprehensive list of available commands.