Note: This is a maintained fork of the abandoned gem geckodriver-helper

Gem Version

Easy installation and use of geckodriver, that provides the HTTP API described by the WebDriver protocol to communicate with Gecko browsers, such as Firefox.


geckodriver-bin installs an executable, geckodriver, in your gem path.

This script will, if necessary, download the appropriate binary for your platform and install it into ~/.geckodriver-bin, then exec it.


If you're using Bundler and Capybara, it's as easy as:

# Gemfile
gem 'geckodriver-bin'

then, in your specs:

Capybara.register_driver :selenium do |app|
  options =
  # Uncomment line below to run firefox in headless mode
  # options.args << '--headless', browser: :firefox, options: options)

Updating Geckodriver

If you'd like to force-upgrade to the latest version of geckodriver, run the script gecko_updater


MIT licensed, see LICENSE.txt for full details.


This is a maintained fork of the gem geckodriver-helper.

The idea and some features comes from @flavorjones's project chromedriver-helper. That saves setup time and works pretty good from the box.