Getting started

Choosing Driver

Selenium2 (with a browser)

It is recommended to run tests locally with the Selenium driver. Using the Selenium driver on a real browser allows you to see the tests running (as opposed to using a headless browser as detailed in the following sections).

You can download Selenium server from here, or install it as follows:

$ mkdir ~/jars
$ cd jars
$ wget

You can then run it:

$ java -jar selenium-server-standalone-2.46.0.jar -browserSessionReuse -singleWindow

The -browserSessionReuse tells selenium NOT to close the window after every test and -singleWindow will cause Selenium not to use more than one window.


You will need to install the Java Runtime Environment. On a debian based system you could do apt-get install default-jre

Selenium2 (headless, with PhantomJs)


It is not currently recommended to run tests on PhantomJS - the results may be unpredictable.

PhantomJS can be installed with npm:

$ npm install phantomjs

You can then run it as follows:

$ phantomjs --webdriver=8643

Then you will need to copy the default behat.yml.dist to behat.yml and add the wd_host option as follows:

    # ...
        # ...
                        wd_host: "http://localhost:8643/wd/hub"

Running the tests

You can run all the tests as follows:

$ ./vendor/behat/behat/bin/behat -p <profile>

Where <profile> is one of:

  • selenium: Tests on your local machine via Selenium using a real browser above)
  • travis: Run configuration for travis


If you want to run the tests on your local machine with the default configuration you have to make sure that a Sulu instance is running on You can use the command ./app/console server:run for that.

The tests are split up into a number of suites. There is one suite for each bundle, named after the bundle in lowercase, for example SuluContactBundle has the suite named contact.

Run specific suites as follows:

$ ./vendor/behat/behat/bin/behat --suite=contact -p <profile>

Further more you can filter for specific tests using the name option:

$ ./vendor/behat/behat/bin/behat --suite=contact --name="Create" -p <profile>

The above will run all scenarios in the contact suite which contain the word Create.