Simple Rails app configuration
Figaro is for configuring Rails (3 and 4) apps, especially open source Rails apps.
Open sourcing a Rails app can be a little tricky when it comes to sensitive configuration information like Pusher or Stripe credentials. You don't want to check private credentials into the repo but what other choice is there?
Figaro provides a clean and simple way to configure your app and keep the private stuff… private.
There are a few similar solutions out there, and a lot of homegrown attempts. Most namespace your configuration under a Config
(or similar) namespace. That's fine, but there's already a place to describe the application environment… ENV
!
ENV
is a collection of simple string key/value pairs and it works just great for application configuration.
As an added bonus, this is exactly how apps on Heroku are configured. So if you configure your Rails app using ENV
, you're already set to deploy to Heroku.
Okay. Add Figaro to your Gemfile and run the bundle
command to install it:
gem "figaro"
Next up, use the generator provided by Figaro:
rails generate figaro:install
This creates a commented config/application.yml
file and ignores it in your .gitignore
. Add your own configuration to this file and you're done!
Your configuration will be available as key/value pairs in ENV
. For example, here's config/initializers/pusher.rb
:
Pusher.app_id = ENV["PUSHER_APP_ID"]
Pusher.key = ENV["PUSHER_KEY"]
Pusher.secret = ENV["PUSHER_SECRET"]
In addition, you can access these same configuration values through Figaro itself:
Pusher.app_id = Figaro.env.pusher_app_id
Pusher.key = Figaro.env.pusher_key
Pusher.secret = Figaro.env.pusher_secret
But wait… I thought configuration via constant was bad! Well, this is different. Rather than storing a copy of ENV
internally, Figaro.env
passes directly through to ENV
, making it just like using ENV
itself. So why two approaches? Having your configurations available via method calls makes it easy to stub them out in tests. Either way is fine. The choice is yours!
If your app requires Rails-environment-specific configuration, you can also namespace your configuration under a key for Rails.env
.
HELLO: world
development:
HELLO: developers
production:
HELLO: users
In this case, ENV["HELLO"]
will produce "developers"
in development, "users"
in production and "world"
otherwise.
NOTE: Figaro uses Rails' standard hooks to initialize. Unfortunately, this hook apparently occurs after database.yml
is read. Because of this issue, environment variables created in application.yml
don't work inside datatabase.yml
.
Heroku's beautifully simple application configuration was the inspiration for Figaro.
Typically, to configure your application ENV
on Heroku, you would do the following from the command line using the heroku
gem:
heroku config:add PUSHER_APP_ID=8926
heroku config:add PUSHER_KEY=0463644d89a340ff1132
heroku config:add PUSHER_SECRET=0eadfd9847769f94367b
heroku config:add STRIPE_API_KEY=jHXKPPE0dUW84xJNYzn6CdWM2JfrCbPE
heroku config:add STRIPE_PUBLIC_KEY=pk_HHtUKJwlN7USCT6nE5jiXgoduiNl3
But Figaro provides a rake task to do just that! Just run:
rake figaro:heroku
Optionally, you can pass in the name of the Heroku app:
rake figaro:heroku[my-awesome-app]
Additionally, if RAILS_ENV
is configured on your Heroku server, Figaro will use that environment automatically in determining your proper configuration.
No problem. Just add config/application.yml
to your production app on the server.
- Fork it.
- Make it better.
- Send me a pull request.
Yes.
[](https://en.wikipedia.org/wiki/Figaro_(Disney\))
Figaro is made possible by the continued contributions and insights from kind-hearted developers everywhere. Just to name a few: