Skip to content
Ruby library for managing YAML config
Ruby Roff
Branch: master
Clone or download
chiliburger Merge pull request #5 from kickstarter/railtie-change
Changed the railtie to use the before_configuration callback so we ca…
Latest commit 7a187d7 Aug 26, 2015


Loads and manages config/*.yml files.

Searches through a few locations to find the right environment config:

  1. config/$name/$env.yml
  2. config/$name.yml (with $env key)
  3. config/$name/default.yml
  4. config/$name.yml (with 'default' key)

Build Status


Add this line to your application's Gemfile:

gem 'configs'

And then execute:

$ bundle

Or install it yourself as:

$ gem install configs


If you have a config/foo.yml, then anywhere you need to read the file you can use Configs[:foo] as a hash.


# config/foo.yml
  hello: world

# Elsewhere (even in a config/initializer)
=> 'world'

You can include ERB in the YAML files:

# config/foo.yml
  database_password: <%= ENV['DATABASE_PASSWORD'] %>


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Copyright 2014 Kickstarter, Inc

Released under an MIT License

You can’t perform that action at this time.