Install or update the Azure Developer CLI

Welcome to the Azure Developer CLI (azd)! Let's get started with installing and learning how to run azd.

Start by selecting your development environment. For more information about the pros and cons of the different development environment choices, see Azure Developer CLI (azd) supported environments.

For more advanced installation scenarios and instructions, see Azure Developer CLI Installer Scripts

Note: When you install azd, the following tools are installed within azd scope (meaning they are not installed globally) and are removed if azd is uninstalled:

• The GitHub CLI
• The Bicep CLI

Windows Package Manager (winget)

Install azd

winget install microsoft.azd

Update azd

winget upgrade microsoft.azd

Uninstall azd

winget uninstall microsoft.azd

Chocolatey

Install azd

choco install azd

Update azd

choco upgrade azd

Uninstall azd

choco uninstall azd

Script

Install azd

The install script downloads and installs the MSI package on the machine with default parameters.

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Update azd

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Uninstall azd

Once you've installed the MSI versions, using the uninstall script to remove azd will leave some items behind on the machine. Instead, for version 0.5.0-beta.1 and later:

1. Search for Add or remove programs in Windows.

2. Locate Azure Dev CLI and select the three dots to expand the options menu.

3. Select Uninstall.

Homebrew (recommended)

Note

On Apple Silicon Macs (M1 and M2) azd requires Rosetta 2. If Rosetta 2 is not already installed run softwareupdate --install-rosetta from the terminal.

Install azd

brew tap azure/azd && brew install azd

The brew tap azure/azd command only needs to be run once to configure the tap in brew.

If using brew to upgrade azd from a version not installed using brew, remove the existing version of azd using the uninstall script (if installed to the default location) or by deleting the azd binary manually.

Update azd

brew upgrade azd

Uninstall azd

brew uninstall azd

Script

Install azd

The install script can be used to install azd at the machine scope.

curl -fsSL https://aka.ms/install-azd.sh | bash

Update azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Uninstall azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

Apple Silicon (beta, manual)

Install azd

Note

There is an ARM64 build of azd available for Apple Silicon Macs (M1 and M2). Support for ARM64 azd is beta. Report issues with ARM64 builds by filing an issue in the Azure Developer CLI GitHub repo.

1. Download azd-darwin-arm64-beta.zip from Azure Developer CLI GitHub Releases
2. Unzip the the .zip file
3. Ensure that azd-darwin-arm64-beta is executable (chmod +x azd-darwin-arm64-beta)
4. Copy azd-darwin-arm64-beta to a location in $PATH (e.g. /usr/local/bin/azd)

Script

Install azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Update azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

When you install azd, the following tools are installed within azd scope (meaning they are not installed globally) and are removed if azd is uninstalled:

• The Git CLI
• The Bicep CLI

Uninstall azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

.deb package

The Azure Developer CLI releases signed .deb and .rpm packages to GitHub Releases. To install or update, download the appropriate file from the GitHub release and run the appropriate command to install the package:**

Install or Update .deb package for azd

You can install the .deb package using apt-get:

curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd_<version>_amd64.deb -o azd_<version>_amd64.deb
apt update 
apt install ./azd_<version>_amd64.deb -y

Uninstall .deb package for azd

apt remove -y azd

Note

You may need to use sudo when running apt.

.rpm package

The Azure Developer CLI releases signed .deb and .rpm packages to GitHub Releases. To install, download the appropriate file from the GitHub release and run the appropriate command to install the package:**

Install .rpm package for azd

You can install the .rpm package using yum install:

curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd-<version>-1.x86_64.rpm -o azd-<version>-1.x86_64.rpm
yum install -y azd-<version>-1.x86_64.rpm 

Uninstall .rpm package for azd

yum remove -y azd

Note

You may need to use sudo when running yum.

ARM64 (beta, manual)

Install azd

Note

There is an ARM64 build of azd available for ARM64 Linux. Support for ARM64 azd is beta. Report issues with ARM64 builds by filing an issue in the Azure Developer CLI GitHub repo.

1. Download azd-linux-arm64-beta.tar.gz from Azure Developer CLI GitHub Releases
2. Extract the .tar.gz file
3. Ensure that azd-linux-arm64-beta is executable (chmod +x azd-linux-arm64-beta)
4. Copy azd-linux-arm64-beta to a location in $PATH (e.g. /usr/local/bin/azd)

Dev Container

A Dev Container is a Docker image that includes all of the prerequisites you need to run this app on your local machine. To get started, make sure you have the pre-requisites before choosing your azd template.

Pre-requisites

Before you get started using azd, ensure you have:

• Installed:
  • Docker Desktop (other options coming soon.)
  • Remote - Containers VS Code Extension
• An Azure account with an active subscription. Create one for free.

Updating the Azure Developer CLI

When working with an out of date version of azd, you will see a warning to upgrade to the latest version. Follow the instructions in the warning to update to the latest version.

Request help

For information on how to file a bug, request help, or propose a new feature for the Azure Developer CLI, please visit the troubleshooting and support page.

Next steps

Choose an azd template