Supported platforms

The following table shows a mapping between geckodriver releases, and required versions of Selenium and Firefox:

geckodriver Selenium Firefox
min max
0.26.0 ≥ 3.11 (3.14 Python) 60 n/a
0.25.0 ≥ 3.11 (3.14 Python) 57 n/a
0.24.0 ≥ 3.11 (3.14 Python) 57 n/a
0.23.0 ≥ 3.11 (3.14 Python) 57 n/a
0.22.0 ≥ 3.11 (3.14 Python) 57 n/a
0.21.0 ≥ 3.11 (3.14 Python) 57 n/a
0.20.1 ≥ 3.5 55 62
0.20.0 ≥ 3.5 55 62
0.19.1 ≥ 3.5 55 62
0.19.0 ≥ 3.5 55 62
0.18.0 ≥ 3.4 53 62
0.17.0 ≥ 3.4 52 62

Clients

Selenium users must update to version 3.11 or later to use geckodriver. Other clients that follow the W3C WebDriver specification are also supported.

Firefoxen

geckodriver is not yet feature complete. This means that it does not yet offer full conformance with the WebDriver standard or complete compatibility with Selenium. You can track the implementation status of the latest Firefox Nightly on MDN. We also keep track of known Selenium, remote protocol, and specification problems in our issue tracker.

Support is best in Firefox 57 and greater, although generally the more recent the Firefox version, the better the experience as they have more bug fixes and features. Some features will only be available in the most recent Firefox versions, and we strongly advise using the latest Firefox Nightly with geckodriver. Since Windows XP support in Firefox was dropped with Firefox 53, we do not support this platform.

Android

Starting with the 0.26.0 release geckodriver is able to connect to Android devices, and to control packages which are based on GeckoView (eg. Firefox Preview aka Fenix, or Firefox Reality). But it also still supports versions of Fennec up to 68 ESR, which is the last officially supported release from Mozilla.

To run tests on Android specific capabilities under moz:firefoxOptions have to be set when requesting a new session. See the Android section under Firefox Capabilities for more details.