azd app run

Starts your development environment based on project type with support for multi-service orchestration.

Usage

Terminal window
azd app run [flags]

Flags

Flag Short Type Default Description
--service -s string - Run specific service(s) only (comma-separated)
--runtime - string azd Runtime mode: 'azd' (azd dashboard) or 'aspire' (native Aspire with dotnet run)
--env-file - string - Load environment variables from .env file
--verbose -v bool false Enable verbose logging
--dry-run - bool false Show what would be run without starting services
--web -w bool false Open dashboard in browser

Examples

Terminal window
azd app run [flags]
Terminal window
azd app run
Terminal window
azd app run --service web,api
Terminal window
azd app run --runtime aspire
Terminal window
azd app run --dry-run
Terminal window
azd app run --verbose
Terminal window
azd app run --env-file .env.local
Terminal window
azd app run -s web -v --runtime aspire

📚 Detailed Documentation

For complete documentation including flows, diagrams, and advanced usage, see the full command specification.

View full run specification →