Old Guides - You are viewing the guides for Ember v2.1.0.
Go to v5.0.0

Installing Ember

Edit pencil

Getting started with Ember.js is easy. Ember.js projects are created and managed through our command line build tool Ember CLI. This tool provides:

  • Modern application asset management (including concatenation, minifying, and versioning)
  • Generators to help you create components, routes, and more
  • A conventional project layout, so approaching existing Ember.js applications is easy
  • Support for ES2015/ES6 JavaScript via the Babel project. This includes support for JavaScript modules, which are used throughout this guide.
  • A complete QUnit test harness
  • The ability to consume a growing ecosystem of Ember Addons

Dependencies

Node.js and npm

Ember CLI is built with JavaScript, and expects the Node.js runtime. It also requires dependencies fetched via npm. npm is packaged with Node.js, so if your computer has Node.js installed you are ready to go.

Ember requires Node.js 0.12 or higher and npm 2.7 or higher. If you're not sure whether you have Node.js, run this on your command line:

node --version

The output should give a version number. If it gives a "command not found" error instead:

Once you've got Node.js installed, re-run node --version to verify your computer's setup.

Git

Ember requires Git to manage many of its dependencies. Git comes with Mac OS X and most Linux distributions. Windows users can download and run this Git installer.

Watchman (optional)

On Mac and Linux, you can improve file watching performance by installing Watchman.

Installation

Install Ember using npm:

npm install -g ember-cli

While you're at it we recommend you also install PhantomJS to run tests from the command line (without the need for a browser to be open):

npm install -g phantomjs2

To verify that your installation was successful, run:

ember -v

If the result is something like version: 1.13.0, you're ready to go.

On this page