Skip to main content
Version: v8

Capacitor CLI - cap run

This command first runs sync, then it builds and deploys the native app to a target device of your choice.

To enable running on wireless iOS devices, follow the instructions detailed here.

npx cap run [options] <platform>

Inputs:

  • platform (required): android, ios

Options:

  • --flavor <flavorName>: set the flavor of the Android project (flavor dimensions not yet supported)
  • --list: Print a list of target devices available to the given platform
  • --no-sync: do not run the sync command
  • --scheme <schemeName>: set the scheme of the iOS project
  • --configuration <name>: Configuration name of the iOS Scheme
  • --target <id>: Run on a specific target device
  • --target-name <name>: Run on a specific target device by its name (ex: "iPhone 17 Pro", "John's iPhone")
  • --target-name-sdk-version <version>: Run on a target device by name with a specific sdk version when using --target-name, (ex: "26.0" for iOS 26 or "35" for Android API 35). Useful for targets that have the same name but have different OS / SDK versions
  • --live-reload: Set live-reload URL via CLI (uses defaults, overrides server.url config)
  • -l: Shorthand for --live-reload
  • --host <host>: Configure host for live-reload URL (used with --live-reload)
  • --port <port>: Configure port for live-reload URL (used with --live-reload)
  • --https: Use https:// instead of http:// for live-reload URL (used with --live-reload)
  • --forwardPorts <port1:port2>: Automatically run "adb reverse" for better live-reloading support