Ionic CLI

Contents

The Ionic command-line interface (CLI) is your go-to tool for developing Ionic apps.

Installation

The Ionic CLI can be installed globally with npm:

$ npm install -g ionic

Help

The Ionic CLI ships with command documentation that is accessible with the --help flag.

$ ionic <command> --help

Architecture

The Ionic CLI is built with TypeScript and Node.js. It supports Node 6+, but the latest Node LTS is always recommended. Follow development on the open source GitHub repository.

Troubleshooting

To troubleshoot issues with the Ionic CLI, the following may be useful:

  • Make sure the latest version of the Ionic CLI is installed. Update with npm install -g ionic@latest.
  • Make sure the latest Node LTS is installed. See Node & npm environment setup.
  • The --verbose flag prints debugging messages, which may narrow down the issue.
  • Connection issues may be due to improperly configured proxy settings. See Using a Proxy to configure request proxying.
  • The global Ionic CLI configuration directory is ~/.ionic on all platforms. It can safely be deleted and the Ionic CLI will repopulate it, but all configuration (including user sessions) will be lost. Configure this directory with CLI environment variables.
Edit this page Updated 2019-04-29