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 aren't installed globally) and are removed if azd is uninstalled:
azd
winget install microsoft.azd
Update azd
winget upgrade microsoft.azd
Uninstall azd
winget uninstall microsoft.azd
Install azd
choco install azd
Update azd
choco upgrade azd
Uninstall azd
choco uninstall azd
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
Using the uninstall script to remove azd
leaves some items behind on the machine. Instead, for version 0.5.0-beta.1 and later:
Search for Add or remove programs in Windows.
Locate Azure Dev CLI and select the three dots to expand the options menu.
Select Uninstall.
The Arm64 version of azd
is available to download directly on the GitHub release page. Currently, there is no direct support for package manager installers or other channels.
azd
Note
If your machine already has the Windows x86_64 version of azd
installed, first uninstall the x86_64 version to prevent MSI upgrades or repairs from writing over the Arm64 executable.
On the GitHub release page page, download the latest azd-windows-arm64-alpha.zip
file.
Extract the azd-windows-arm64-alpha.zip
file and copy the azd-windows-amd64.exe
executable to the default azd
location C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI
on your device.
Add an entry to the PATH
environment variable on your device to point to the extracted file at C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe
.
azd
On the GitHub release page page, download the latest azd-windows-arm64-alpha.zip
file.
Extract the azd-windows-arm64-alpha.zip
file and copy the azd-windows-amd64.exe
executable to the default azd
location C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI
on your device to replace the existing executable.
Verify you have a PATH
environment variable on your device that points to the extracted file at C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe
.
azd
Remove the azd-windows-amd64.exe
executable from the default azd
location C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI
on your device. If you installed azd
in a different location, you'll need to delete it from there.
Remove the PATH
environment variable you added to point to the azd
install location.
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.
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 you're 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.
azd
brew upgrade azd
Uninstall azd
brew uninstall azd
Note
The azd
install process will automatically choose the correct binary for the architecture of the machine.
The install script can be used to install the correct version of 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
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 aren't installed globally) and are removed if azd is uninstalled:
azd
curl -fsSL https://aka.ms/uninstall-azd.sh | bash
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:**
.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
.
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:**
.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
.
Before you get started using azd
, ensure you have:
azd
in a dev container
A dev container is a Docker image that includes all of the prerequisites you need to run an app on your local machine. Install azd
as a feature in your dev container via the following steps:
Add the azd
feature to the devcontainer.json
file in the .devcontainer
folder at the root of your template.
{
"name": "Azure Developer CLI",
"image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
"features": {
// See https://containers.dev/features for list of features
"ghcr.io/devcontainers/features/docker-in-docker:2": {
},
"ghcr.io/azure/azure-dev/azd:latest": {}
}
// Rest of file omitted...
}
Rebuild and run your dev container. In Visual Studio Code, use the command palette to execute the Rebuild and Reopen in Dev Container command.
Verify your azd
installation completed successfully by running the azd version
command in a terminal:
azd version
azd
prints the current version:
azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)
Update the Azure Developer CLI
When working with an out of date version of azd
, you'll see a warning to upgrade to the latest version. Follow the instructions in the warning to update to the latest version.
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 stepsQuickstart - Select and deploy an azd template
What are Azure Developer CLI templates?
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4