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

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

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 opencode@microsoft.com.

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.