Expose .env variables in Ember applications

Downloads in past


002.0.15 years ago5 years agoMinified + gzip package size for @jasonmit/ember-cli-dotenv in KB


Ember CLI Dotenv
ember install @jasonmit/ember-cli-dotenv
Upgrading to @jasonmit/ember-cli-dotenv@2.0.0
  • npm uninstall ember-cli-dotenv
  • ember install @jasonmit/ember-cli-dotenv
  • open dotenv.js and ember-cli-build.js
  • Move/convert the dotEnv application options from ember-cli-build.js to the function declared within dotenv.js
NOTE: if your path is dynamic see Multiple Environments
What is Ember CLI Dotenv?
This addon allows you to write environment variables in a .env file and expose them to your Ember app through the built-in config/environment.js that you can import in your app. For example, you might be building an app with Dropbox and don’t want to check your key into the repo. Put a .env file in the root of your repository:

Next, configure dotenv.js.
// dotenv.js
module.exports = function(env) {
  return {
    clientAllowedKeys: ['DROPBOX_KEY']

All keys in .env are currently injected into node’s process.env. These will be available in your config/environment.js file:
// config/environment.js
module.exports = function(environment) {
  return {
    MY_OTHER_KEY: process.env.MY_OTHER_KEY

You can then use the node process environment variables in other ember-cli-addons, such as express middleware or other servers/tasks.
Security: environment variables in config/environment.js are never filtered unlike using .env and clientAllowedKeys. Remember to use the environment variable passed into your config function to filter out secrets for production usage. Never include sensitive variables in clientAllowedKeys, as these will be exposed publicly via ember's <meta name="app/config/environment"> tag.
then, you can access the environment variables anywhere in your app like you usually would.
import ENV from "my-app/config/environment";


You can read more about dotenv files on their dotenv repositorydotenv.
All the work is done by ember-cli and dotenvdotenv. Thanks ember-cli team and dotenv authors and maintainers! Thanks Brandon Keepers for the original dotenv ruby implementation.

Multiple Environments

Sometime people may want to use different .env file than the one in project root. This can be configured as below:
// dotenv.js
module.exports = function(env) {
  return {
    clientAllowedKeys: ['DROPBOX_KEY'],
    path: './path/to/.env'

In addition, you may also customize for different environments:
// dotenv.js
module.exports = function(env) {
  return {
    clientAllowedKeys: ['DROPBOX_KEY'],
    path: `./path/to/.env-${env}`

With the above, if you run ember build --environment production, the file ./path/to/.env.production will be used instead.


This addon supports the Ember 2.x series, but it is also backwards-compatible down to Ember-CLI 0.1.2 and Ember 1.7.0.

Other Resources

Development Installation

  • git clone this repository
  • npm install
  • bower install


  • ember server
  • Visit your app at http://localhost:4200.

Running Tests

  • npm test (Runs ember try:testall to test your addon against multiple Ember versions)
  • ember test
  • ember test --server


  • ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.