Old Guides - You are viewing the guides for Ember v1.12.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 another developer's 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.


Ember.js installs through the npm. Install the Ember.js build tools with npm.

npm install -g ember-cli

Testing your installation

When installation completes, test your install to ensure it worked by generating a new project:

ember new my-app

This will create a new my-app directory and generate an application structure for you.

Once the generation process finishes, verify that you can run the newly created application:

cd my-app
ember server

Navigate to http://localhost:4200 to see your new app in action.


Got Node, npm, and Git?

ember-cli requires Node.js 0.12 or higher, npm 2.7 or higher, and Git.

Node Package Manager (npm) comes bundled with node.js. If you're not sure if you have node.js installed, try running the following command in your terminal:

node --version

If you have node installed you'll see a message like 0.12.x in your terminal.

If you don't have node 0.12 or higher installed:

Once you've got node.js installed, run the node --version command again to verify your install.

Git comes with Mac OS X and most Linux distributions. Windows users can download and run the installer.