Edit Page

CLI commands reference


In their daily work, most Ember developers use only a small number of CLI commands. See the Basic use section for a guide to common CLI commands and options.

This page shows a full list of Ember CLI commands and options. You can view this information at anytime by typing the following

ember --help

As Ember CLI is constantly evolving it's best to use this command to view the latest help for the version of Ember CLI you are currently using.

Available commands in Ember CLI (alphabetical):

ember addon <addon-name> <options...>
  Generates a new folder structure for building
   an addon, complete with test harness.
  --dry-run (Boolean) (Default: false)
    aliases: -d
  --verbose (Boolean) (Default: false)
    aliases: -v
  --blueprint (String) (Default: addon)
    aliases: -b <value>
  --skip-npm (Boolean) (Default: false)
    aliases: -sn
  --skip-bower (Boolean) (Default: false)
    aliases: -sb
  --skip-git (Boolean) (Default: false)
    aliases: -sg
  --yarn (Boolean)
  --directory (String)
    aliases: -dir <value>
  --lang (String) Sets the base human language of the addon's own test application via index.html
ember asset-sizes <options...>
  Shows the sizes of your asset files.
  --output-path (Path) (Default: dist/)
    aliases: -o <value>
  --json (Boolean) (Default: false)
ember build <options...>
  Builds your app and places it into the output
   path (dist/ by default).
  aliases: b
  --environment (String) (Default: development)
   Possible values are "development", "production", and "test".
    aliases: -e <value>, -dev
     (--environment=development), -prod
      (--environment=production)
  --output-path (Path) (Default: dist/)
    aliases: -o <value>
  --watch (Boolean) (Default: false)
    aliases: -w
  --watcher (String)
  --suppress-sizes (Boolean) (Default: false)
ember destroy <blueprint> <options...>
  Destroys code generated by `generate` command.
  aliases: d
  --dry-run (Boolean) (Default: false)
    aliases: -d
  --verbose (Boolean) (Default: false)
    aliases: -v
  --pod (Boolean) (Default: false)
    aliases: -p, -pods
  --classic (Boolean) (Default: false)
    aliases: -c
  --dummy (Boolean) (Default: false)
    aliases: -dum, -id
  --in-repo-addon (String) (Default: null)
    aliases: --in-repo <value>, -ir <value>
  --in (String) (Default: null) Runs a blueprint 
  against an in repo addon. A path is expected,
   relative to the
    root of the project.
ember generate <blueprint> <options...>
  Generates new code from blueprints.
  aliases: g
  --dry-run (Boolean) (Default: false)
    aliases: -d
  --verbose (Boolean) (Default: false)
    aliases: -v
  --pod (Boolean) (Default: false)
    aliases: -p, -pods
  --classic (Boolean) (Default: false)
    aliases: -c
  --dummy (Boolean) (Default: false)
    aliases: -dum, -id
  --in-repo-addon (String) (Default: null)
    aliases: --in-repo <value>, -ir <value>
  --in (String) (Default: null) Runs a blueprint
   against an in repo addon. A path is expected,
    relative to the root of the project.
ember help <command-name (Default: all)> <options...>
  Outputs the usage instructions for all commands
   or the provided command
  aliases: h, --help, -h
  --verbose (Boolean) (Default: false)
    aliases: -v
  --json (Boolean) (Default: false)
ember init <glob-pattern> <options...>
  Creates a new ember-cli project in the current folder.
  --dry-run (Boolean) (Default: false)
    aliases: -d
  --verbose (Boolean) (Default: false)
    aliases: -v
  --blueprint (String)
    aliases: -b <value>
  --skip-npm (Boolean) (Default: false)
    aliases: -sn
  --skip-bower (Boolean) (Default: false)
    aliases: -sb
  --welcome (Boolean) (Default: true) Installs and
   uses {{ember-welcome-page}}. Use --no-welcome to
    skip it.
  --yarn (Boolean)
  --name (String) (Default: "")
    aliases: -n <value>
  --lang (String) Sets the base human language of the application via index.html
ember install <addon-name> <options...>
  Installs an ember-cli addon from npm.
  aliases: i
  --save (Boolean) (Default: false)
    aliases: -S
  --save-dev (Boolean) (Default: true)
    aliases: -D
  --save-exact (Boolean) (Default: false)
    aliases: -E, --exact
  --yarn (Boolean) Use --yarn to enforce yarn 
  usage, or --no-yarn to enforce npm
ember new <app-name> <options...>
  Creates a new directory and runs ember init in it.
  --dry-run (Boolean) (Default: false)
    aliases: -d
  --verbose (Boolean) (Default: false)
    aliases: -v
  --blueprint (String) (Default: app)
    aliases: -b <value>
  --skip-npm (Boolean) (Default: false)
    aliases: -sn
  --skip-bower (Boolean) (Default: false)
    aliases: -sb
  --skip-git (Boolean) (Default: false)
    aliases: -sg
  --welcome (Boolean) (Default: true) Installs and
   uses {{ember-welcome-page}}. Use --no-welcome to
    skip it.
  --yarn (Boolean)
  --directory (String)
    aliases: -dir <value>
  --lang (String) Sets the base human language of the application via index.html
ember serve <options...>
  Builds and serves your app, rebuilding on file changes.
  aliases: server, s
  --port (Number) (Default: 4200) To use a port different
   than 4200. Pass 0 to automatically pick an available
    port.
    aliases: -p <value>
  --host (String) Listens on all interfaces by default
    aliases: -H <value>
  --proxy (String)
    aliases: -pr <value>, -pxy <value>
  --proxy-in-timeout (Number) (Default: 120000) When
   using --proxy: timeout (in ms) for incoming requests
    aliases: -pit <value>
  --proxy-out-timeout (Number) (Default: 0) When using
   --proxy: timeout (in ms) for outgoing requests
    aliases: -pot <value>
  --secure-proxy (Boolean) (Default: true) Set to false 
  to proxy self-signed SSL certificates
    aliases: -spr
  --transparent-proxy (Boolean) (Default: true) Set to false 
  to omit x-forwarded-* headers when proxying
    aliases: --transp
  --watcher (String) (Default: events)
    aliases: -w <value>
  --live-reload (Boolean) (Default: true)
    aliases: -lr
  --live-reload-host (String) Defaults to host
    aliases: -lrh <value>
  --live-reload-base-url (String) Defaults to baseURL
    aliases: -lrbu <value>
  --live-reload-port (Number) 
  Defaults to same port as ember app
    aliases: -lrp <value>
  --live-reload-prefix (String) (Default: _lr) 
  Default to _lr
    aliases: --lrprefix <value>
  --environment (String) (Default: development) P
  ossible values are "development", "production", and "test".
    aliases: -e <value>, -dev (--environment=development),
     -prod (--environment=production)
  --output-path (Path) (Default: dist/)
    aliases: -op <value>, -out <value>
  --ssl (Boolean) (Default: false) Set to true to 
  configure Ember CLI to serve using SSL.
  --ssl-key (String) (Default: ssl/server.key) 
  Specify the private key to use for SSL.
  --ssl-cert (String) (Default: ssl/server.crt) 
  Specify the certificate to use for SSL.
  --path (Path) Reuse an existing build at given path.
ember test <options...>
  Runs your app's test suite.
  aliases: t
  --environment (String) (Default: test) Possible values 
  are "development", "production", and "test".
    aliases: -e <value>
  --config-file (String)
    aliases: -c <value>, -cf <value>
  --server (Boolean) (Default: false)
    aliases: -s
  --host (String)
    aliases: -H <value>
  --test-port (Number) (Default: 7357) The test port
   to use when running tests. Pass 0 to automatically
    pick an available port
    aliases: -tp <value>
  --filter (String) A string to filter tests to run
    aliases: -f <value>
  --module (String) The name of a test module to run
    aliases: -m <value>
  --watcher (String) (Default: events)
    aliases: -w <value>
  --launch (String) (Default: false) A comma 
  separated list of browsers to launch for tests.
  --reporter (String) Test reporter to use
  [tap|dot|xunit] (default: tap)
    aliases: -r <value>
  --silent (Boolean) (Default: false) Suppress
   any output except for the test report
  --ssl (Boolean) (Default: false) Set to true
   to configure testem to run the test suite
    using SSL.
  --ssl-key (String) (Default: ssl/server.key) 
  Specify the private key to use for SSL.
  --ssl-cert (String) (Default: ssl/server.crt)
   Specify the certificate to use for SSL.
  --testem-debug (String) File to write a 
  debug log from testem
  --test-page (String) Test page to invoke
  --path (Path) Reuse an existing build at
   given path.
  --query (String) A query string to append 
  to the test page URL.
  --output-path (Path)
    aliases: -o <value>
ember version <options...>
  outputs ember-cli version
  aliases: v, --version, -v
  --verbose (Boolean) (Default: false)
Available commands from @ember/optional-features:
ember feature
  Prints the USAGE.

ember feature:list
  List all available features.

ember feature:enable <feature-name> <options...>
  Enable feature.
  --run-codemod (Boolean) run any associated
   codemods without prompting

ember feature:disable <feature-name> <options...>
  Disable feature.
  --run-codemod (Boolean) run any associated
   codemods without prompting
Available commands from ember-cli-template-lint:
ember template-lint:print-failing
  Get current list of all failing templates. 
  This can be used to update the `pending` 
  listing in `.template-lintrc.js`.