</>KemmerApp

Python

How to run headless Firefox with Selenium in Python

25 September 2026 · 6 min read

How to run headless Firefox with Selenium in Python

In the dynamic world of web automation and testing, the ability to execute browser tasks without a visible user interface has become a game-changer. This concept, known as headless browsing, offers significant advantages in terms of speed, resource efficiency, and integration into continuous integration/continuous deployment (CI/CD) pipelines. Mastering how to run headless Firefox with Selenium in Python is a crucial skill for developers, QAs, and data scientists looking to streamline their automation workflows, perform robust web scraping, or conduct efficient automated testing. This guide will walk you through the process, from setting up your environment to writing the Python code that brings headless Firefox to life, ensuring your automation scripts run faster and more reliably.

Understanding Headless Browsing with Selenium

Headless browsing refers to the operation of a web browser without its graphical user interface (GUI). Instead of opening a visible window on your screen, the browser operates entirely in the background, processing web pages and executing scripts just as a regular browser would. This mode is particularly useful for automated tasks that don’t require human interaction or visual feedback, such as web scraping, automated testing, generating PDFs, or performing server-side rendering.

When you run headless Firefox with Selenium in Python, you leverage Selenium’s powerful WebDriver API to control the Firefox browser programmatically. The key benefit here is performance optimization; without the overhead of rendering a GUI, headless browsers consume fewer system resources (CPU and memory) and can execute tasks significantly faster. This makes them ideal for environments like cloud servers or CI/CD pipelines where graphical displays are often unavailable or unnecessary. According to industry benchmarks, headless tests can complete up to 30% faster than their GUI counterparts, especially in large test suites, demonstrating a clear advantage for modern development practices.

The core idea is to simulate user interaction with a website, navigate pages, fill forms, click buttons, and extract data, all without a browser window popping up. This seamless execution allows for more efficient and scalable browser automation, making it a cornerstone for modern web development and testing strategies. Whether you’re building a data collection pipeline or ensuring your web application functions flawlessly, headless Firefox provides a robust and reliable solution.

Prerequisites for Headless Firefox Automation

Before you can begin writing your Python script to run headless Firefox, you need to ensure your environment is properly set up. This involves installing a few essential components that allow Selenium to communicate with and control the Firefox browser. Getting these prerequisites right is crucial for a smooth automation experience and avoiding common setup headaches.

First and foremost, you’ll need Python installed on your system. Python 3.6 or newer is generally recommended for compatibility with modern libraries. You can download the latest version from the official Python website. Once Python is installed, the next step is to install the Selenium library. This can be done easily using pip, Python’s package installer, by running pip install selenium in your terminal or command prompt. This command fetches the necessary packages to enable browser automation from your Python scripts.

Beyond Python and Selenium, you must have the Firefox browser itself installed. Selenium needs an actual browser instance to control, even if it’s running in headless mode. Finally, and critically, you need the GeckoDriver. GeckoDriver is a proxy for the W3C WebDriver specification that allows Selenium to interact with Firefox. You’ll need to download the appropriate version of GeckoDriver for your operating system from the Mozilla GeckoDriver releases page. Once downloaded, extract the executable file (geckodriver.exe on Windows, geckodriver on macOS/Linux) and place it in a directory that is included in your system’s PATH environment variable, or specify its path directly in your Python script. This ensures that Selenium can find and launch the driver when you initialize Firefox WebDriver.

Ensuring these components are correctly installed and configured forms the foundation for any successful Selenium browser automation project. Without GeckoDriver, Selenium simply won’t be able to establish a connection with Firefox, leading to runtime errors. Taking a few minutes to verify each of these steps will save significant debugging time later.

Step-by-Step Guide: Running Headless Firefox

Once your environment is set up with Python, Selenium, Firefox, and GeckoDriver, you’re ready to write the Python code to execute headless Firefox. The process involves configuring Firefox options to enable headless mode and then initializing the WebDriver with these options. This sequence is fundamental for any automation script designed to run without a visible browser window.

Here’s a breakdown of the steps involved in your Python script:

  1. Import WebDriver: Begin by importing the necessary modules from Selenium. You’ll need webdriver from selenium and Options from selenium.webdriver.firefox.options.

    from selenium import webdriver from selenium.webdriver.firefox.options import Options

  2. Set up Firefox Options for Headless Mode: Create an instance of Options and add the --headless argument. This is the critical step that tells Firefox to run without a GUI.

    firefox_options = Options() firefox_options.add_argument("--headless")

  3. Initialize WebDriver with Options: Instantiate the Firefox WebDriver, passing your configured firefox_options. If GeckoDriver is not in your system’s PATH, you’ll also need to specify its executable path here using the executable_path argument.

    If geckodriver is in PATH: driver = webdriver.Firefox(options=firefox_options) If geckodriver is not in PATH, specify its location: driver = webdriver.Firefox(executable_path='/path/to/geckodriver', options=firefox_options)

  4. Perform Actions: With the headless browser launched, you can now perform any standard Selenium actions. This includes navigating to URLs, finding elements, interacting with forms, and extracting data. For example, to visit a Question & Answer :

    I am running this code with python, selenium, and firefox but still get ‘head’ version of firefox:

    binary = FirefoxBinary('C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe', log_file=sys.stdout) binary.add_command_line_options('-headless') self.driver = webdriver.Firefox(firefox_binary=binary)

    I also tried some variations of binary:

    binary = FirefoxBinary('C:\\Program Files\\Nightly\\firefox.exe', log_file=sys.stdout) binary.add_command_line_options("--headless")

    To invoke Firefox Browser headlessly, you can set the headless property through Options() class as follows:

    from selenium import webdriver from selenium.webdriver.firefox.options import Options options = Options() options.headless = True driver = webdriver.Firefox(options=options, executable_path=r'C:\Utility\BrowserDrivers\geckodriver.exe') driver.get("http://google.com/") print ("Headless Firefox Initialized") driver.quit()

    There’s another way to accomplish headless mode. If you need to disable or enable the headless mode in Firefox, without changing the code, you can set the environment variable MOZ_HEADLESS to whatever if you want Firefox to run headless, or don’t set it at all.

    This is very useful when you are using for example continuous integration and you want to run the functional tests in the server but still be able to run the tests in normal mode in your PC.

    $ MOZ_HEADLESS=1 python manage.py test # testing example in Django with headless Firefox

    or

    $ export MOZ_HEADLESS=1 # this way you only have to set it once $ python manage.py test functional/tests/directory $ unset MOZ_HEADLESS # if you want to disable headless mode

    Steps through YouTube Video

    Outro

    How to configure ChromeDriver to initiate Chrome browser in Headless mode through Selenium?