Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
317 lines (207 sloc) 10.5 KB

Generic Selenium WebDriver Install Speedrun checklist

Basic steps:

  • Install Java and supporting tools
    • install Java JDK
    • install Maven
    • check Java and Maven work by running a sample test
  • Install IntelliJ
    • check IntelliJ works by running the sample test
  • Install WebDriver Supporting Tools
    • download and Install Chrome
    • download and Install Firefox
    • download and install Marionette GeckoDriver
    • download and Install ChromeDriver
    • check installs work by running the sample tests

Install Videos

Windows Install Videos

Mac Install Videos


Windows Install Speedrun checklist

Install Java Pre-requisites

You need to have Java, Maven and IntelliJ installed.

For instructions on how to install Java, Maven and IntelliJ; and check they are working, use the checklist in startUsingJavaJunit project:

Note: I currently recommend using ChromeDriver as your default driver and the current version of Chrome as your default browser. If you only setup one driver and browser, make it Chrome, it is a lot easier to start with.


Install Firefox GeckoDriver or ChromeDriver the 'fast' way on Windows

Both GeckoDriver and ChromeDriver are available to install via Chocolatey


Install Firefox GeckoDriver or ChromeDriver the 'long' way on Windows

Note: You only really have to install one of these to get started. I recommend ChromeDriver and Chrome.


Install Chrome and ChromeDriver on Windows

  • [ ]Install Current version of Chrome
  • [ ]download ChromeDriver add it to the path
  • [ ]in startUsingSeleniumWebDriver folder run command mvn test -Dtest=MyFirstChromeTest
    • If you did everything correctly then Chrome should have started and a test should have run

Install Firefox and GeckoDriver on Windows

  • [ ] Install Current version of Firefox
  • [ ]download GeckoDriver add it to the path
  • [ ]in startUsingSeleniumWebDriver folder run command mvn test -Dtest=MyFirstTest
    • If you did everything correctly then Firefox should have started and a test should have run

Install Sample WebDriver Project on Windows


  • Check the most up to date version of WebDriver
    • [ ]check for most up to date version of WebDriver in the unzipped pom.xml file
    • [ ]amend the pom.xml file if the version number is not up to date
    • [ ]exit IntelliJ

The version number is contained in this section of the pom.xml e.g. this says use version 3.13.0 of Selenium WebDriver

        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
			<version>3.13.0</version>
        </dependency>

Run Test From IDE on Windows

  • [ ]Back in IntelliJ

  • [ ]run MyFirstTest, or MyFirstTestFF48 or MyFirstChromeTest class

    • [ ]right click on the class in the project window and select "Run
  • [ ]When the test runs from the IDE, you are finished your install and setup


Mac Install Speedrun checklist - Homebrew

Install Java Pre-requisites

For instructions on how to install Java, Maven and IntelliJ; and check they are working, use the checklist in startUsingJavaJunit project:


Install WebDriver Sample Project on Mac

Note: Currently recommend using ChromeDriver as your default driver and the current version of Chrome as your default browser. If you only setup one driver and browser, make it Chrome, it is a lot easier to start with.


  • [ ]open project for the unzipped pom.xml file

  • [ ]check most up to date version of webdriver in the unzipped pom.xml file

    • [ ]check the Selenium webdriver downloads page or the maven page for the up to date version
      • I do not recommend using a beta version
    • [ ]amend the pom.xml file if the version number is not up to date
    • [ ]exit IntelliJ

Install SafarDriver on Mac

SafariDriver is built into the Mac operating system.

We need to enable remote execution in Safari Browser to use it.

  • Safari \ Preferences \ Advanced
    • [x] show develop menu in menu bar
  • Develop \ Allow Remote Execution

Install Firefox and GeckoDriver on Mac

Install Homebrew if you don't already have it.

  • [ ] Install Current version of Firefox
    • either with cask brew cask install firefox
      • or visit the site and install
  • [ ] Install GeckoDriver

Install Chrome and ChromeDriver on Mac


Install Firefox GeckoDriver or ChromeDriver the 'long' way on Mac

Remember you can skip this step if you used HomeBrew.

Firefox GeckoDriver the 'long' way on Mac

  • [ ]download GeckoDriver add it to the path

ChromeDriver the 'long' way on Mac

  • [ ] Install ChromeDriver * [ ]download ChromeDriver add it to the path * https://sites.google.com/a/chromium.org/chromedriver/ * extract into a folder * add folder path to .bash_profile * export PATH=$PATH:/folder/you/extracted/it/to * [ ]in startUsingSeleniumWebDriver folder run command mvn test -Dtest=MyFirstChromeTest

Run Test From IDE on Windows or Mac

  • [ ] Back in IntelliJ

  • [ ] run MyFirstTest, or MyFirstChromeTest or MyFirstSafariTest class depending on which drivers you installed

    • [ ]right click on the class in the project window and select "Run
  • [ ]When the test runs from the IDE, you are finished your install and setup


Generic Links:



Selenium Simplified

Online Training and blog teaching Selenium WebDriver with Java

By Alan Richardson


Legacy Firefox install instructions

  • [ ] If install ESR version of Firefox (45) https://www.mozilla.org/en-US/firefox/organizations/faq/ * [ ]no need to download any extra drivers * if using WebDriver 2.53.1 * [ ]in startUsingSeleniumWebDriver folder run command mvn test -Dtest=MyFirstTest * if using WebDriver 3.0.1 (or above) * [ ]in startUsingSeleniumWebDriver folder run command mvn test -Dtest=MyFirstLegacyFFTest