Installing ChromeDriver on macOS

The ChromeDriver getting started guide wasn’t super helpful with it’s installation instructions, mainly because I was unfamiliar with including the ChromeDriver location in my PATH environment variable (you have to help Chrome find the downloaded ChromeDriver). Don’t get me wrong, I’ve updated PATH variables on Windows for years but never on a Mac. In my search for more helpful instructions I came up with a more helpful and revised install guide for ChromeDriver. 

Top ways to install ChromeDriver:

  1. As many people have noted, the easiest way to install ChromeDriver is to use brew install chromedriver. This requires you have Homebrew installed, but you probably should anyways.
  2. Specify it in your Selenium setup code. If you go this route, you can include GeckoDriver as well.
  3. Run the whole thing in a container using Docker.
  4. Download the driver and add its location to your System PATH.

System PATH Setup

The following instructions will help you create your own PATH to a unique folder on your Mac or copy the file to an existing PATH directory for ChromeDriver.

  1. Download the ChromeDriver executable.
  2. Now we need to tell Selenium where it is and for that we have a few choices.To do this:
    1. Open up Terminal
    2. Run sudo nano /etc/paths
    3. Enter your password
    4. Go to the bottom of the file and enter the path you wish to add
    5. My PATH looks like: /Users/name/Documents/WebDriver
    6. Control-x to quit
    7. Y to save
    8. Press enter to confirm
  3. To double check, quit Terminal and relaunch it. Run echo $PATH. You should see your newly added path in the stream of other paths already there.
  4. Finally, update your tests to run using Chrome and run your tests!

After running your tests, if your PATH isn’t set up correctly you get this helpful message:

Selenium::WebDriver::Error::WebDriverError: Unable to find the chromedriver executable. Please download the server from and place it somewhere on your PATH. More info at

Additional References:

Updated: 09/02/2017

  • Robin Linus

    Thanks for your instructions!
    There is a little typo… you meant:
    sudo nano /etc/paths

  • Everett Griffiths

    Hmmm…. incomplete…. not sure why the selenium-standalone is looking for the executable in the wrong place:

    ERROR: The driver executable does not exist: /usr/local/lib/node_modules/selenium-standalone/.selenium/chromedriver/2.20-x64-chromedriver

    browserName: “chrome”

    • Check to make sure your PATH is set up / pointed correctly!

      • Everett Griffiths

        The problem was that I hadn’t re-run “selenium-standalone install” after re-installing. It’s easy to forget because basic stuff works, but some drivers don’t get installed.

  • rubytester

    if you use brew on Mac I would recommend `brew install chromedriver`

    • ataraxio

      Thanks @rubytester:disqus, `brew install chromedriver` works for me 🙂

  • Thankyou

    Thanks man this was really good article! 🙂 You are right, ChromeDriver’s instructions sucked

  • Garron Sanchez

    Great article, Chris! I was still having some trouble getting my path work correctly, but I was able to use homebrew to get access to chromedriver. All I did was: brew install chromedriver

  • Maggie Jones

    Thanks for this!

  • tone D

    Easy steps to follow – Thanks!!