Install

Install/Upgrade Azure Developer CLI

Before you get started, ensure you have the following tools installed on your local machine:

• Git
• GitHub CLI v2.3+ (only required for azd pipeline config when using GitHub Actions)
• Azure Developer CLI (azd)

The installation scripts can also be used to update azd in place. Run the script again to install the latest available released version.

To install daily test builds of azd see Download from daily builds

For advanced install scenarios see Azure Developer CLI Installer Scripts

Windows:

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

MacOS/Linux:

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

Docker container

Make sure you have Docker Desktop installed. Run the following command to get the az-dev-cli-apps container that includes all the prerequisites.

docker run -it mcr.microsoft.com/azure-dev-cli-apps:latest

Uninstall Azure Developer CLI

To uninstall the Azure Developer CLI:

Windows:

Uninstalling 0.5.0-beta.1 and later

The Azure Developer CLI uses MSI to install on Windows. Use the "Add or remove programs" dialog in Windows to remove the "Azure Developer CLI" application.

Uninstalling version 0.4.0-beta.1 and earlier

Use this PowerShell script to uninstall Azure Developer CLI 0.4.0-beta.1 and earlier.

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

Linux/MacOS:

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

Install the VS Code extension

1. Download the extension from https://aka.ms/azure-dev/vsix
2. In vscode
   1. Open "Extensions" (Ctrl+Shift+X)
   2. Click the ... menu at top of Extensions sidebar
   3. Click "Install from VSIX"
   4. Select location of downloaded file

Azure Developer CLI Templates

Refer to Sample templates