Skip to content

Commit 02bfde5

Browse files
alexeaglevikerman
authored andcommitted
docs: add install instructions to pull a snapshot build (#11988)
Would like to point users here when they ask why their bug was closed but the problem is still visible in `@latest`
1 parent d55deb9 commit 02bfde5

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

docs/documentation/home.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Angular CLI
44

5-
NOTE: this documentation is for Angular CLI 6. For Angular CLI 1.x go [here](1-x/home) instead.
5+
NOTE: this documentation is for Angular CLI 6. For Angular CLI 1.x go [here](1-x-home) instead.
66

77
### Overview
88
The Angular CLI is a tool to initialize, develop, scaffold and maintain [Angular](https://angular.io) applications
@@ -13,6 +13,10 @@ To install the Angular CLI:
1313
npm install -g @angular/cli
1414
```
1515

16+
> If you get an error installing the CLI, this is an issue with your local npm setup on your machine, not a problem in Angular CLI.
17+
> Please have a look at the [fixing npm permissions page](https://docs.npmjs.com/getting-started/fixing-npm-permissions), [common errors page](https://docs.npmjs.com/troubleshooting/common-errors), [npm issue tracker](https://github.com/npm/npm/issues), or open a new issue if the problem you are experiencing isn't known.
18+
> To install a different version, see below.
19+
1620
Generating and serving an Angular project via a development server
1721
[Create](new) and [run](serve) a new project:
1822
```
@@ -63,3 +67,12 @@ End-to-end tests are run via [Protractor](http://www.protractortest.org/).
6367
### Additional Information
6468
There are several [stories](stories) which will walk you through setting up
6569
additional aspects of Angular applications.
70+
71+
### Installing a specific version
72+
The CLI is installed both globally (the command above with the `-g` argument to `npm install`) and also within the project. To install a different version of the CLI, you can just update the version locally within your project. The globally installed package will always delegate to the local one.
73+
74+
There are several different versions available at any time:
75+
- Install a previous version, maybe because of a bug in the latest version. For example to get 6.0.2: `npm install @angular/cli@6.0.2`
76+
- Install the pre-release of a newer minor/major version, to try new features. For example to get 7.0.0-beta.3: `npm install @angular/cli@next`. Note that the `@next` version is only useful during beta periods.
77+
- Install a snapshot build from the latest passing run of our CI (angular-cli/master). This is useful if an issue was just fixed or a new feature just landed on master, but is not yet released: `npm install @angular/cli@github:angular/cli-builds` (or maybe better, find the particular SHA that you want to try:
78+
`npm install @angular/cli@github:angular/cli-builds#0123456789abcdef`)

0 commit comments

Comments
 (0)