> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/angular/angular/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Set up Angular on your local development environment and install the Angular CLI to start building applications.

## Prerequisites

Before you begin, ensure your development environment includes the following:

### Node.js

Angular requires an active LTS or maintenance LTS version of Node.js. Check the specific version requirements:

* **Minimum version**: Node.js 18.x or later
* **Recommended**: Latest LTS version

Verify your Node.js installation:

```bash theme={null}
node --version
```

### npm or pnpm

Angular uses npm (Node Package Manager) or pnpm for dependency management. npm is included with Node.js.

Verify your package manager:

```bash theme={null}
npm --version
```

Or if using pnpm:

```bash theme={null}
pnpm --version
```

## Install Angular CLI

The Angular CLI is a command-line interface tool that helps you initialize, develop, scaffold, and maintain Angular applications.

### Install globally

Install the Angular CLI globally using npm:

```bash theme={null}
npm install -g @angular/cli
```

Or using pnpm:

```bash theme={null}
pnpm add -g @angular/cli
```

<Note>
  The `-g` flag installs the CLI globally, making the `ng` command available from any directory.
</Note>

## Verify installation

After installation, verify that the Angular CLI is installed correctly:

```bash theme={null}
ng version
```

This command displays the installed Angular CLI version along with Node.js and operating system information:

```bash theme={null}
Angular CLI: 21.2.0
Node: 20.14.8
Package Manager: npm 10.30.3
OS: darwin x64
```

## System requirements

### Operating systems

Angular CLI supports the following operating systems:

* **Windows**: Windows 10 or later
* **macOS**: macOS 10.13 or later
* **Linux**: Most modern Linux distributions

### Browsers

Angular applications run in modern browsers. The framework supports:

* Chrome (latest)
* Firefox (latest)
* Edge (latest)
* Safari (latest)

### TypeScript

Angular is built with TypeScript. The Angular CLI automatically installs the correct TypeScript version for your Angular version. Current Angular versions use:

* **TypeScript**: 5.9.3 or later

<Note>
  You don't need to install TypeScript separately. The Angular CLI manages TypeScript as a project dependency.
</Note>

## Update Angular CLI

To update the Angular CLI to the latest version:

```bash theme={null}
npm install -g @angular/cli@latest
```

For existing projects, update local CLI version:

```bash theme={null}
ng update @angular/cli @angular/core
```

## Troubleshooting

### Permission errors on macOS/Linux

If you encounter permission errors during global installation, avoid using `sudo`. Instead, configure npm to install global packages in your home directory:

```bash theme={null}
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
```

Add the export line to your `~/.profile` or `~/.bashrc` file.

### Clear cache

If you experience installation issues, clear the npm cache:

```bash theme={null}
npm cache clean --force
```

## Next steps

Now that Angular CLI is installed, you're ready to create your first Angular application.

<Card title="Create your first app" icon="rocket" href="/getting-started/first-app">
  Learn how to create and run your first Angular application
</Card>