SeleniumBase Driver with uc mode on works on Windows but fails on Linux (connection refused)

[Khald1998]

I encountered an issue when using SeleniumBase with uc=True (undetected-chromedriver mode) on Linux. The same code runs Fine on Windows, but on Linux, it throws a connection refused error.

Code

from seleniumbase import Driver

url = "https://www.google.com/"
search_term = "buy gift card online site:.us"

driver = Driver(browser='chrome', uc=True)
try:
    driver.open(url)
    print(f"Opened URL: {url}")
    search_box_selector = 'textarea[name="q"]'
    driver.wait_for_element(search_box_selector, timeout=15)
    driver.type(search_box_selector, search_term, timeout=15)
    driver.submit(search_box_selector)
    print(f"Submitted search for '{search_term}'")
    driver.sleep(10)
    a_tags = driver.find_elements('#search a')
    print(f"Found {len(a_tags)} link elements on page")
except Exception as e:
    print("Error:", e)
finally:
    driver.quit()

Error on Linux

root@cg-catcher:~/cg-catcher# venv/bin/python test.py
Opened URL: https://www.google.com/
Submitted search for 'buy gift card online site:.us'
Error: HTTPConnectionPool(host='localhost', port=58639): Max retries exceeded with url: /session/9db0efbb11b508001bb59f3a4ad37772/elements (Caused by NewConnectionError("HTTPConnection(host='localhost', port=58639): Failed to establish a new connection: [Errno 111] Connection refused"))

My Observations

• Works on Windows – The exact same script runs successfully on Windows with uc=True.
• Works on Linux without uc – If I change uc=True to uc=False on Linux, the script runs without errors (though obviously without the undetected mode).
• When using the SB and the "with" block, it works fine on Windows and Linux.

My Environment

• OS: Linux (Debian-based, root user in a container)

My question is, why does this happen when I use Driver instead of SB? I am curious.

[mdmintz]

The Driver() format doesn't have the special Xvfb virtual display code that's needed when running on a GUI-less Linux machine.
Instead, you should use the SB() format when running UC Mode on a GUI-less Linux machine.

There are lots of UC + CDP Mode examples running on Linux, such as: https://github.com/mdmintz/undetected-testing/actions/runs/21800048455/job/62893966876#step:17:1