Shim to load environment variables from
ENV in development.
Storing configuration in the environment is one of the tenets of a twelve-factor app. Anything that is likely to change between deployment environments–such as resource handles for databases or credentials for external services–should be extracted from the code into environment variables.
But it is not always practical to set environment variables on development machines or continuous integration servers where multiple projects are run. dotenv loads variables from a
.env file into
ENV when the environment is bootstrapped.
dotenv is intended to be used in development. If you would like to use it in production or other environments, see dotenv-deployment
Add this line to the top of your application's Gemfile:
gem 'dotenv-rails', :groups => [:development, :test]
And then execute:
It should be listed in the Gemfile before any other gems that use environment variables, otherwise those gems will get initialized with the wrong values.
Install the gem:
$ gem install dotenv
As early as possible in your application bootstrap process, load
require 'dotenv' Dotenv.load
Alternatively, you can use the
dotenv executable to launch your application:
$ dotenv ./script.py
.env is loaded in rake, load the tasks:
require 'dotenv/tasks' task :mytask => :dotenv do # things that require .env end
Add your application configuration to your
.env file in the root of your project:
An alternate yaml-like syntax is supported:
S3_BUCKET: yamlstyleforyours3bucket SECRET_KEY: thisisalsoanokaysecret
Whenever your application loads, these variables will be available in
config.fog_directory = ENV['S3_BUCKET']
It is recommended that you store development-only settings in your
.env file, and commit it to your repository. Make sure that all your credentials for your development environment are different from your other deployments. This makes it easy for other developers to get started on your project, without compromising your credentials for other environments.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request