webdriverio-workflo/docs/guide/services/selenium-standalone.md

This is a customized version of webdriverio for use with workflo framework.

name: selenium-standalone
category: services
tags: guide
index: 4
title: WebdriverIO - Selenium Standalone Service
---

Selenium Standalone Service
===========================

Handling the Selenium server is out of scope of the actual WebdriverIO project. This service helps you to run Selenium seamlessly when running tests with the [WDIO testrunner](http://webdriver.io/guide/testrunner/gettingstarted.html). It uses the well known [selenium-standalone](https://www.npmjs.com/package/selenium-standalone) NPM package that automatically sets up the standalone server and all required drivers for you.

## Installation

The easiest way is to keep `wdio-selenium-standalone-service` as a devDependency in your `package.json`.

```json
{
  "devDependencies": {
    "wdio-selenium-standalone-service": "~0.1"
  }
}
```

You can simple do it by:

```bash
npm install wdio-selenium-standalone-service --save-dev
```

Instructions on how to install `WebdriverIO` can be found [here.](http://webdriver.io/guide/getstarted/install.html)

## Configuration

By default, Google Chrome, Firefox and PhantomJS are available when installed on the host system. In order to use the service you need to add `selenium-standalone` to your service array:

```js
// wdio.conf.js
exports.config = {
  // ...
  services: ['selenium-standalone'],
  // ...
  // Options are set here as well
  seleniumLogs: './logs',
  //...
};
```

## Options

### seleniumLogs
Path where all logs from the Selenium server should be stored.

Type: `String`

### seleniumArgs
Object configuration for selenium-standalone.start().

Type: `Object`<br>
Default: `{}`

### seleniumInstallArgs
Object configuration for selenium-standalone.install().

Type: `Object`<br>
Default: `{}`