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

FlagShortTypeDefaultDescription
--service-sstring-Run specific service(s) only (comma-separated)
--runtime-stringazdRuntime mode: 'azd' (azd dashboard) or 'aspire' (native Aspire with dotnet run)
--env-file-string-Load environment variables from .env file
--verbose-vboolfalseEnable verbose logging
--dry-run-boolfalseShow what would be run without starting services
--restart-containers-boolfalseRestart containers even if they are already running
--force-fboolfalseForce clean dependency reinstall (passes --force to deps)
--web-wboolfalseOpen 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
Terminal window
azd app run --force

📚 Detailed Documentation

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

View full run specification →