layout: post title: Running Capybara-Webkit on CentOS author: Matt Robbins categories: - testing - cucumber - capybara - webkit —

Capybara-Webkit is a headless driver for Capybara that uses Qt-Webkit. Although it does not actually create a head (and therefore should be a great deal quicker than say running firefox via Xvfb) it still needs an X11 server running for access to fonts etc, Xvfb will do the job just fine.

Running this on CentOS is complicated by a number of factors:

  1. No official CentOS RPMs for Qt (or at least upto date ones)
  2. No official CentOS RMPs for Ruby 1.8.7
  3. Need to setup and run Xvfb.

The following guide should get you well on the way…


Install Xvfb

yum install Xvfb Xorg

Install Ruby 1.8.7 (as no CentOS RPM exists we must compile from source)

yum install -y gcc zlib zlib-devel  
tar xvf ruby-1.8.7-p330.tar.gz  
cd ruby-1.8.7-p330  
./configure --enable-pthread  
make install

You may need to add the ruby executable to your path.

Install RubyGems 1.3.7

Download: and unzip run setup.rb

Install Qt

Add the following repo using rpm:

rpm -ivh


yum groupinstall Qt4  
yum groupinstall Qt4-Devel

Add the qtmake binary to your path e.g.

export PATH=$PATH:/usr/lib64/qt4/bin

Testing your Xvfb setup

You can do this using Firefox…

yum install firefox

Start Xvfb:

Xvfb :1 -screen 0 1024x768x16 -nolisten inet6  (the no listen flag suppresses warnings related to no IPv6 support)
export DISPLAY=localhost:1.0 (exports the display)
DISPLAY=localhost:1.0 firefox (starts a headless firefox)

Using the headless gem

It is probably easiest to use the headless gem to manage your Xvfb server

For an example program using firefox and selenium-webdriver you could do something like the following:

require 'rubygems'
require 'bundler/setup'
require 'headless'
require 'selenium-webdriver'

headless =

driver = Selenium::WebDriver.for :firefox ''
p driver.browser
puts driver.title


Using Capybara-Webkit with Cucumber

Your env.rb could look something like this:

require 'capybara/cucumber'
require 'capybara-webkit'
require 'headless'

headless =

Capybara.javascript_driver = :webkit
Capybara.run_server = false

at_exit do