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
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.
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
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:
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:
- 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
Feedback
Submit and view feedback for