azd app run
Starts your development environment based on project type with support for multi-service orchestration.
Usage
azd app run [flags]Flags
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--service | -s | string | - | 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 | - | bool | false | Run the app in the background and return to the shell |
--runtime | - | string | azd | Runtime 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 | - | bool | false | Skip reqs and dependency installation before starting services |
--verbose | -v | bool | false | Enable verbose logging |
--dry-run | - | bool | false | Show what would be run without starting services |
--no-timing | - | bool | false | Hide the per-service startup timing summary shown after services are ready |
--restart-containers | - | bool | false | Restart containers even if they are already running |
--force | -f | bool | false | Force clean dependency reinstall (passes --force to deps) |
--trust | - | bool | false | Trust this workspace for code execution and remember the decision |
--skip-secret-scan | - | bool | false | Skip the advisory scan for hardcoded secrets in tracked config |
--skip-exposure-check | - | bool | false | Skip the warning shown when a service binds to all network interfaces |
--web | -w | bool | false | Open dashboard in browser |
Examples
azd app run [flags]azd app runazd app run --service web,apiazd app run --runtime aspireazd app run --dry-runazd app run --verboseazd app run --env-file .env.localazd app run -s web -v --runtime aspireazd app run --forceDetailed Documentation
For complete documentation including flows, diagrams, and advanced usage, see the full command specification.
View full run specification →