Azure Developer CLI (azd)

From code to cloud in minutes. A developer-centric CLI to build, deploy, and operate Azure applications.

---

Built for you

• ⚡ Get productive fast — Streamlined workflows to go from code to cloud in minutes
• 🏗️ Azure recommended practices built-in — Opinionated templates that follow Azure development standards
• 🧠 Learn as you build — Understand core Azure constructs through hands-on experience

📖 Get Started · 💬 Join the Discussion · 📦 Browse Templates

---

Downloads

Artifact	Version	Download
CLI		Windows · Linux · macOS
VS Code Extension		Marketplace

🤖 AI Agents

Contributing to this repo? See AGENTS.md for coding standards and docs/ for contributor documentation.

Microsoft contributor? The repository's agency.toml configures Agency with Azure DevOps and Kusto MCP tools.

Using azd with an AI coding assistant? Check out the docs and templates.

---

Installation

Install or upgrade to the latest version. For advanced scenarios, see the installer docs.

Windows

# Using winget (recommended)
winget install microsoft.azd

# Or Chocolatey
choco install azd

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

macOS

brew trust azure/azd && brew install --cask azure/azd/azd

Note: brew trust azure/azd trusts azd's Homebrew source (the azure/azd tap for github.com/Azure/homebrew-azd). Homebrew requires this before it will install casks from third-party sources.

Note: If upgrading from a non-Homebrew installation, remove the existing azd binary first.

Linux

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

Shell Completion

Enable tab completion for bash, zsh, fish, or powershell:

azd completion <shell> --help

---

Uninstall

• v0.5.0+: Use "Add or remove programs" or your package manager (winget uninstall, choco uninstall)
• v0.4.0 and earlier:

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

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

Or use your package manager's uninstall command.

---

Data Collection

This software may collect usage data and send it to Microsoft to help improve our products. You can opt out by setting:

export AZURE_DEV_COLLECT_TELEMETRY=no

See the Microsoft Privacy Statement for details.

---

Contributing

We welcome contributions! Please see our contributing guide for details.

Most contributions require a Contributor License Agreement (CLA). A bot will guide you through this when you open a PR.

This project follows the Microsoft Open Source Code of Conduct. Questions? Contact [email protected].

Template Authors

Microsoft employees and partners contributing official templates should follow the template standardization guidelines.

---

Trademarks

This project may contain Microsoft trademarks or logos. Use of these must follow Microsoft's Trademark & Brand Guidelines. Third-party trademarks are subject to their respective policies.

License

Licensed under the MIT license.