Search docs/

ionic capacitor run

Run an Ionic project on a connected device

ionic capacitor run <platform> [options]

ionic capacitor run will do the following:

  • Perform ionic build (or run the dev server from ionic serve with the --livereload option)
  • Run capacitor run (or open IDE for your native project with the --open option)

When using --livereload with hardware devices, remember that livereload needs an active connection between device and computer. In some scenarios, you may need to host the dev server on an external address using the --external option. See these docs for more information.

If you have multiple devices and emulators, you can target a specific one by ID with the --target option. You can list targets with --list.

For Android and iOS, you can setup Remote Debugging on your device with browser development tools using these docs.

Examples

ionic capacitor run ionic capacitor run androidionic capacitor run android -l --externalionic capacitor run ios --livereload --externalionic capacitor run ios --livereload-url=http://localhost:8100

Inputs

platform

Description

The platform to run (e.g. android, ios)

Options

--list

Description

List all available targets

--target=<target>

Description

Deploy to a specific device by its ID (use --list to see all)

--open

Description

Open native IDE instead of using capacitor run

--no-build

Description

Do not invoke Ionic build

--external

Description

Host dev server on all network interfaces (i.e. --host=0.0.0.0)

--livereload

Description

Spin up dev server to live-reload www files

Aliases-l

--livereload-url=<url>

Description

Provide a custom URL to the dev server

--prod

Description

Flag to use the production configuration

Advanced Options

--host=<host>

Description

Use specific host for the dev server

Defaultlocalhost

--port=<port>

Description

Use specific port for the dev server

Aliases-p
Default8100

--public-host=<host>

Description

The host used for the browser or web view

--configuration=<conf>

Description

Specify the configuration to use.

Aliases-c

--source-map

Description

Output source maps

--watch

Description

Rebuild when files change