Skip to content

⚙️ Downloading drivers

Installing webdrivers

To run web automation, you need webdrivers for each browser you plan on using. With SeleniumBase, drivers are downloaded automatically (as needed) into the SeleniumBase drivers/ folder.

You can also download drivers manually with these commands:

seleniumbase get chromedriver
seleniumbase get geckodriver
seleniumbase get edgedriver

After running the commands above, web drivers will get downloaded into the seleniumbase/drivers/ folder. SeleniumBase uses those drivers during tests. (The drivers don't come with SeleniumBase by default.)

If the necessary driver is not found in this location while running tests, SeleniumBase will instead look for the driver on the System PATH. If the necessary driver is not on the System PATH either, SeleniumBase will automatically attempt to download the required driver.

  • You can also download specific versions of drivers. Examples:
sbase get chromedriver 114
sbase get chromedriver 114.0.5735.90
sbase get chromedriver stable
sbase get chromedriver beta
sbase get chromedriver dev
sbase get chromedriver canary
sbase get chromedriver previous  # One major version before the stable version
sbase get chromedriver mlatest  # Milestone latest version for detected browser
sbase get edgedriver 115.0.1901.183

(NOTE: sbase is a shortcut for seleniumbase)

If you plan on using the Selenium Grid integration (which allows for remote webdriver), you'll need to put the drivers on your System PATH. On macOS and Linux, /usr/local/bin is a good PATH spot. On Windows, you may need to set the System PATH under Environment Variables to include the location where you placed the driver files. As a shortcut, you could place the driver files into your Python Scripts/ folder in the location where you have Python installed, which should already be on your System PATH.

Here's where you can go to manually get web drivers from the source:

macOS shortcuts:

  • You can also install drivers by using brew (aka homebrew):
brew install --cask chromedriver

brew install geckodriver

You can also upgrade existing webdrivers:

brew upgrade --cask chromedriver

brew upgrade geckodriver

Linux shortcuts:

If you still need drivers, these scripts download chromedriver and geckodriver to a Linux machine:

wget https://chromedriver.storage.googleapis.com/114.0.5735.90/chromedriver_linux64.zip
unzip chromedriver_linux64.zip
mv chromedriver /usr/local/bin/
chmod +x /usr/local/bin/chromedriver

wget https://github.com/mozilla/geckodriver/releases/download/v0.34.0/geckodriver-v0.34.0-linux64.tar.gz
tar xvfz geckodriver-v0.34.0-linux64.tar.gz
mv geckodriver /usr/local/bin/
chmod +x /usr/local/bin/geckodriver

To verify that web drivers are working, follow these instructions.