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

Installing Ember

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

  • Modern application asset management (including concatenation, minification, and versioning).
  • Generators to help create components, routes, and more.
  • A conventional project layout, making existing Ember applications easy to approach.
  • 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.



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.

Node.js and npm

Ember CLI is built with JavaScript, and requires the most recent LTS version of 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.

If you're not sure whether you have Node.js or the right version, run this on your command line:

node --version
npm --version

If you get a "command not found" error or an outdated version for Node:

If you get an outdated version of npm, run npm install -g npm.

Watchman (optional)

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


Install Ember using npm:

npm install -g ember-cli

To verify that your installation was successful, run:

ember -v

If a version number is shown, you're ready to go.