Old Guides - You are viewing the guides for Ember v1.13.0. VIEW v3.28.0
Edit Page

Installing Ember

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

  • Modern application asset management (including combining, minifying, and versioning).
  • Built-in generators to help you create components, routes, and more.
  • A conventional project layout so approaching other developers' Ember.js applications is easy.
  • Official JavaScript modules to keep your project organized.
  • A complete testing framework.
  • Access to a growing ecosystem of Ember Addons.


Node.js and npm

Ember CLI is installed using npm (the Node Package Manager), which is bundled with Node.js. Ember requires Node.js 0.12 or higher and npm 2.7 or higher. If you're not sure whether you have Node.js, try running from your command line:

node --version

If you get back something like 0.12.x, you're ready to go.

If you don't:

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


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 the installer.

Watchman (optional)

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


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 phantomjs

To verify that your installation was successful, run:

ember -v

If you get back something like version: 1.13.0, you're ready to go.