Getting Started


Add the gem to your gemfile

To use Conductor with your Rails project, you need to install the accompanying rails-conductor gem. To do so, add the following line to your project’s Gemfile:

gem 'rails-conductor', group: :development

Or, if you already have a development group in your gemfile, place it in the group like so:

group :development
  gem 'rails-conductor'
end

Note of caution

Conductor is meant to be a development tool and shouldn’t be used in test or production, so make sure the gem is only installed for the development environment. Check out the FAQ for more information.

Install gem

Next run

bundle install

and restart your app. Log files will now be output in XML instead of plain text and can be read by Conductor.

Clear your existing logs

Now run

rake log:clear

to clear any existing plain text log files. Note that if you skip this step and there’s any lingering plain text log data in your log files, Conductor will be unable to open them since it’s expecting the logs to contain XML.

Open the log in Conductor

Cooductor detects running Rails apps and makes their log files easily accessible from the Open Running submenu of the File menu. Or, you can hit ⎇⌘O to open the log file for the Rails app running on the lowest port number.

That’s it—you’re ready to go!