Step 1

Install azd + extension

~5 minutes
Marks this step as complete and saves your progress

Let's start by installing the Azure Developer CLI and the azd app extension. This is the foundation for everything else in the tour.

Prerequisites

  • Windows 10/11, macOS 10.15+, or Ubuntu 20.04+
  • Administrator/sudo access for installation

Install Azure Developer CLI

Choose the installation method for your platform:

bash 
winget install microsoft.azd

Install the azd app Extension

Once azd is installed, enable extensions and install azd app:

bash 
# Enable extensions
azd config set alpha.extensions.enabled on

# Add the azd app extension source
azd extension source add -n app -t url -l https://raw.githubusercontent.com/jongio/azd-app/main/registry.json

# Install the extension
azd extension install jongio.azd.app

Clone the Demo Project

For this tour, we'll use the demo project which has everything set up for you:

bash 
# Initialize the demo project
azd init -t jongio/azd-app-demo

# Navigate to the project
cd azd-app-demo

Verify Installation

bash 
# Check azd version
azd version

# Verify the extension is installed
azd app --help

Try It Yourself

Run the commands above to install azd app and clone the demo project.

Expected: You should have azd installed, the azd app extension working, and be inside the azd-app-demo folder.

Using the MSI Installer (Windows)

If winget is not available, you can download the MSI installer directly from the Azure Developer CLI releases page.

Using a Script (All Platforms)

The installation script can be customized with environment variables to control the installation directory and other options.

Docker

azd is also available as a Docker image for CI/CD pipelines and containerized environments.