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:

Install azd

winget install microsoft.azd

Update azd

winget upgrade microsoft.azd

Uninstall azd

winget uninstall microsoft.azd

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.

The azd install process will automatically choose the correct binary for the architecture of your machine.

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. This will automatically install the correct version.

Update azd

brew upgrade azd

Uninstall azd

brew uninstall azd

Install azd

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

Update azd

curl -fsSL https://aka.ms/install-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:

Uninstall azd

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

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:

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