Step 2

Check requirements

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

Before running the demo project, let's verify your system meets all requirements. The azd app reqs command checks everything automatically.

Check System Requirements

From the demo project folder, run the requirements check:

bash 
# Make sure you're in the demo project
cd azd-app-demo

# Check requirements
azd app reqs

This command checks for:

  • Docker - Required for running containerized services
  • Docker Compose - For orchestrating multi-container apps
  • Git - For version control and cloning templates
  • .NET SDK - Required for .NET Aspire projects
  • Node.js - For the dashboard and JavaScript projects

Expected Output

You should see a list of requirements with their status:

Checking requirements...

✓ Docker: Installed (v24.0.6)
✓ Docker Compose: Installed (v2.21.0)
✓ Git: Installed (v2.42.0)
✓ .NET SDK: Installed (v8.0.100)
✓ Node.js: Installed (v20.10.0)

All requirements met! You're ready to run azd-app.

Fixing Missing Requirements

If any requirements are missing, install them before continuing:

Docker

Install Docker Desktop for Windows and macOS, or Docker Engine for Linux.

.NET SDK

bash 
# Windows (winget)
winget install Microsoft.DotNet.SDK.8

# macOS (Homebrew)
brew install dotnet-sdk

# Linux (package manager)
sudo apt install dotnet-sdk-8.0

Try It Yourself

Run `azd app reqs` and ensure all requirements show a green checkmark.

Expected: All items should show ✓ with their version numbers. If anything is missing, install it before proceeding.

Minimum Versions

  • Docker: 20.10 or later
  • Docker Compose: 2.0 or later
  • Git: 2.30 or later
  • .NET SDK: 8.0 or later (for .NET Aspire projects)
  • Node.js: 18.0 or later (LTS recommended)

Platform-Specific Notes

Windows: Ensure WSL2 is enabled for Docker Desktop. macOS: Rosetta 2 may be required on Apple Silicon Macs. Linux: Add your user to the docker group to avoid using sudo.