ConfigFor Build Status Code Climate Test Coverage

Framework for generating, uploading and loading config files in Ruby apps.

It offers integrations with Rails and Sinatra.

For generating and uploading configs it Capistrano Task.

It is inspied by config_for in Rails 4.2. If you are using Rails 4.2, you don't need to use the Rails integration, but you might want to use the Capistrano Task.

How to use it?


Add this line to your application's Gemfile:

gem 'config_for'

And then execute:

$ bundle

Or install it yourself as:

$ gem install config_for


Tested against Ruby 1.9.3, 2.0.0, 2.1.2, 2.1.3. Also against 3 versions of rails: 3.2, 4.0 and 4.1.

Capistrano >= 3.0 is required as well as Sinatra >= 1.4.


ConfigFor will automatically load correct integrations for Rails/Sinatra/Capistrano when required. If it does not happen automatically, you can include them by hand:

require 'config_for/rails'
require 'config_for/sinatra'
require 'config_for/capistrano'


Rails 4.2 and up provide config_for method on Rails.application. ConfigFor backports this for Rails > 3.0 and < 4.2.

So you can use:

# config/production.rb
Rails.application.configure do
  config.redis = config_for(:redis) # will load config/redis.yml and get key 'production'


Sinatra has no default way of loading configs, so ConfigFor follows the same as Rails. After loading the integration, Sinatra Classic apps will have the plugin loaded automatically, but Sinatra Modular apps have to register it by hand.

class MyApp < Sinatra::Base
  register ConfigFor::Sinatra

  # loads root + 'config/redis.yml' and gets key of correct 'environment'
  set :redis,


Capistrano is used to deploy the config to servers. ConfigFor provides task generator for various configs. First you have to load it:

# Capfile
require 'config_for/capistrano'

Then you can use it like:

set :database_yml, {
  production: {
    host: 'localhost',
    port: 3306

Which will generate following tasks:

cap database                       # Generate config/database.yml
cap database:remove                # Remove config/database.yml from current and shared path
cap database:reset                 # Reset database config
cap database:upload                # Upload config/database.yml to remote servers

Also it add hook to run database task before deploy:check:linked_files. So the last think you have to do is add config/database.yml to linked_files variable like:

set :linked_files, %w[ config/database.yml ]


If you have your own framework. You need to create your own config_for method. But don't worry. It is easy:

require 'config_for'
module MyApp
  def self.config_for(name)
    ConfigFor.load_config!(MyApp.root.join('config'), name, MyApp.env)


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Run tests (bundle exec rake)
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request