# Installing Ionic

URL: https://ionicframework.com/docs/intro/cli

Ionic apps are created and developed primarily through the Ionic [command-line](/docs/reference/glossary.md#cli) utility. The Ionic CLI is the preferred method of installation, as it offers a wide range of dev tools and help options along the way. It is also the main tool through which to run the app and connect it to other services, such as Appflow.

Try our App Wizard Use our App Wizard to generate an Ionic project visually. Choose a template, custom colors, app icon, and JavaScript Framework to get building quicker.

[Open Wizard](https://ionicframework.com/start)

## Install the Ionic CLI

Before proceeding, make sure your computer has [Node.js](/docs/reference/glossary.md#node) installed. Refer to the [environment setup guide](/docs/intro/environment.md) to prepare your machine.

Install the Ionic CLI with npm:

```shell
npm install -g @ionic/cli
```

If there was a previous installation of the Ionic CLI, it will need to be uninstalled due to a change in package name.

```shell
$ npm uninstall -g ionic
$ npm install -g @ionic/cli
```

**Note**

The `-g` option means *install globally*. When packages are installed globally, `EACCES` permission errors can occur. Consider setting up npm to operate globally without elevated permissions. Refer to [Resolving Permission Errors](/docs/developing/tips.md#resolving-permission-errors) for more information.

## Start an App

Create an Ionic app using one of the pre-made app templates, or a blank one to start fresh. The three most common starters are the `blank` starter, `tabs` starter, and `sidemenu` starter. Get started with the `ionic start` command:

```shell
ionic start
```

![Three thumbnail previews of Ionic app templates: blank, tabs, and side menu.](/docs/assets/images/start-app-thumbnails-d71df18562d433457afa4d0e51216fbb.png)

To learn more about starting Ionic apps, refer to the [Starting Guide](/docs/developing/starting.md).

## Run the App

The majority of Ionic app development can be spent right in the browser using the `ionic serve` command:

```shell
$ cd myApp
$ ionic serve
```

There are a number of other ways to run an app, it's recommended to start with this workflow. To develop and test apps on devices and emulators, refer to the [Running an App Guide](/docs/developing/previewing.md).