import { Notice } from '@cerner/terra-docs';

# Selenium Docker Service

The selenium docker service initializes a containerized [selenium docker](https://github.com/SeleniumHQ/docker-selenium) environment for running functional [WebDriverIO](https://webdriver.io/) tests.

By default, the selenium grid will be deployed locally on the host machine running on port 4444. Google Chrome and Firefox are available on the docker container. Internet Explorer can be enable when using a remote selenium grid that has it available.

## Options

The selenium docker service options are configured via the [test runner CLI options](../about#options).

### disable-selenium-service

A flag to disable the selenium docker service for the test run.

Type: `bool`

Required: `false`

Default: `false`

Example:

<Notice variant="important" ariaLevel="3">

  The selenium docker service is disabled automatically by the test runner if a remote selenium grid is specified.

</Notice>

```js
"scripts": {
  "test:wdio": "terra wdio --disable-selenium-service"
}
```

### seleniumVersion

The docker selenium image version to run tests against. This option is configured via the `wdio.conf.js`.

Type: `string`

Required: `false`

Default: `3.14.0-helium`

Example:

```js
// wdio.conf.js
const { config } = require('@cerner/terra-functional-testing');

config.serviceOptions = {
  seleniumVersion: '3.141.59-20210311',
};

exports.config = config;
```