Skip to main content

Web Driver Management

Automatic Web Driver Management

As of gwen-web v2.34.0, Gwen uses the following embedded web driver manager to automatically download and manage native web driver binaries for you:

Automatic web driver management will only be active if no webdriver.xx.driver properties are set. So if you are upgrading from an older version of Gwen, be sure to remove these from your Gwen settings files if you wish for Gwen to manage native drivers for you.

The embedded manager will auto-detect your current browser version and download and configure the latest web driver binary that is compatible with that browser. So you don't need to do a thing.

Custom Manager Settings and Configuration

If you wish to have more control over driver versions or other aspects of this process, you can configure explicit wdm.* configuration options in your Gwen settings file. See the WebDriverManager documentation for information about these options.

For example, to have the manager download a specific version of a chrome driver:

wdm {
chromeDriverVersion = "<your desired chrome driver version>"

Proxy Configuration

If you are behind a proxy, you will need to set the HTTPS_PROXY variable in your environment.

Manual Web Driver Management

Perform the following if you are using a gwen-web version prior to v2.34.0 or if you would prefer to manage native drivers yourself:

Download and install the native web driver you want

  • Click the link to download the driver binary for your target browser (download the latest one or the version that you wish)
  • Unpack the binary to a location on your drive

Point Gwen to your installed web driver

Once you've install the native driver using one of the methods above, set the path to it in your Gwen settings file with one of the browser specific settings below (depending on your browser and platform):

webdriver {
gecko {
driver = "/path/to/geckodriver"
chrome {
driver = "/path/to/chromedriver"