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)
--except-string-Run every service except the named one(s) (comma-separated); cannot be combined with `--service`
--scale-stringArray-Run multiple instances of a service, for example `--scale worker=3` (repeatable, comma-separated)
--detach-boolfalseRun the app in the background and return to the shell
--runtime-stringazdRuntime mode: 'azd' (azd dashboard) or 'aspire' (native Aspire with dotnet run)
--env-file-string-Load environment variables from .env file
--env-stringArray-Set an environment variable inline as KEY=VALUE (repeatable, overrides --env-file)
--no-deps-boolfalseSkip reqs and dependency installation before starting services
--verbose-vboolfalseEnable verbose logging
--dry-run-boolfalseShow what would be run without starting services
--no-timing-boolfalseHide the per-service startup timing summary shown after services are ready
--restart-containers-boolfalseRestart containers even if they are already running
--force-fboolfalseForce clean dependency reinstall (passes --force to deps)
--trust-boolfalseTrust this workspace for code execution and remember the decision
--skip-secret-scan-boolfalseSkip the advisory scan for hardcoded secrets in tracked config
--skip-exposure-check-boolfalseSkip the warning shown when a service binds to all network interfaces
--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 →