Selenium

Integrate Selenium with Oxylabs Proxies for browser automation and more. Python and Java setup guides with code examples.

Selenium is a tool that helps automate web browser interactions for website testing and more.

Watch our video guide or follow the steps below to integrate Selenium Python or Java with the following Oxylabs proxies:

• Residential & Mobile Proxies
• Datacenter Proxies
• Dedicated Datacenter Proxies (Enterprise)
• Dedicated Datacenter Proxies (Self-service)
• ISP Proxies
• Dedicated ISP Proxies

Python setup

1

Setting up Selenium

Since using the default Selenium module for implementing proxies that require authentication makes the whole process complicated, install Selenium Wire to extend Selenium's Python bindings using pip:

pip install selenium-wire

Another recommended package for this integration is webdriver-manager. It's a package that simplifies the management of binary drivers for different browsers:

pip install webdriver-manager

2

Proxy authentication

Specify your chosen proxy endpoint and account credentials in the following format:

USERNAME = "your_username"
PASSWORD = "your_password"
ENDPOINT = "host:port"

Then adjust their values according to your chosen Oxylabs proxy type:

• Residential & Mobile Proxies
• Datacenter Proxies
• Dedicated Datacenter Proxies (Enterprise)
• Dedicated Datacenter Proxies (Self-service)
• ISP Proxies
• Dedicated ISP Proxies

Residential & Mobile Proxies

Host: pr.oxylabs.io

Port: 7777

Username: customer-USERNAME

Password: PASSWORD

Note: Don't forget to add customer- prefix to your username.

You may also use additional parameters with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the Residential Proxies documentation to learn more.

Datacenter Proxies

Host: dc.oxylabs.io

Port: 8001

Username: user-username

Password: password

Note: Don't forget to add user- prefix to your username.

Pay-per-IP subscription

The port is the sequential number assigned to an IP address from the proxy list. Thus, port 8001 uses the first IP address from your list. You may also enable proxy IP rotation by setting the port to 8000.

Furthermore, you can specify the geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.

Pay-per-traffic subscription

The port 8001 picks a random IP address but stays consistent during a session. Alternatively, you can rotate proxy IPs with each request by using port 8000.

If you want to use a specific geo-location, for example, the US, set the Proxy username to user-USERNAME-country-US.

Dedicated Datacenter Proxies (Enterprise)

Host: 1.2.3.4 (IP address from your proxy list)

Port: 60000 (HTTP), 1180 (SOCKS5)

Username: username

Password: password

For Enterprise Dedicated Datacenter Proxies (purchased through sales team), you’ll have to choose an IP address from the acquired proxy list.

Dedicated Datacenter Proxies (Self-service)

Host: ddc.oxylabs.io

Port: 8001

Username: user-username

Password: password

Note: Don't forget to add user- prefix to your username.

For Self-Service Dedicated Datacenter Proxies (purchased through Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

ISP Proxies

Host: isp.oxylabs.io

Port: 8001

Username: user-username

Password: password

Note: Don't forget to add user- prefix to your username.

With ISP Proxies, the port is assigned to a specific IP address and its location. Hence, port 8001 will always pick the first IP from your proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

Dedicated ISP Proxies

Host: disp.oxylabs.io

Port: 8001

Username: user-username

Password: password

Note: Don't forget to add user- prefix to your username.

You will need to choose the port assigned to an IP address from the purchased proxy list, which you can find on the Oxylabs dashboard. The 8001 port will pick the first IP address from your list for all requests. Use port 8000 for automatic proxy IP rotation.

3

Testing the connection

Check if the proxy is working by visiting ip.oxylabs.io. If everything is working correctly - it will return an IP address of a proxy you're using.

try:
    driver.get("https://ip.oxylabs.io/")
    return f'\nYour IP is: {driver.find_element(By.CSS_SELECTOR, "pre").text}'
finally:
    driver.quit()

4

Code sample

Complete code for Oxylabs Residential Proxies integration with Selenium:

from selenium.webdriver.common.by import By
from seleniumwire import webdriver
# A package to have a chromedriver always up-to-date.
from webdriver_manager.chrome import ChromeDriverManager

USERNAME = "your_username"
PASSWORD = "your_password"
ENDPOINT = "pr.oxylabs.io:7777"

def chrome_proxy(user: str, password: str, endpoint: str) -> dict:
    wire_options = {
        "proxy": {
            "http": f"http://{user}:{password}@{endpoint}",
            "https": f"https://{user}:{password}@{endpoint}",
        }
    }

    return wire_options

def execute_driver():
    options = webdriver.ChromeOptions()
    options.add_argument('--headless')
    proxies = chrome_proxy(USERNAME, PASSWORD, ENDPOINT)
    driver = webdriver.Chrome(
    ChromeDriverManager(driver_version='<VERSION>').install(), options=options, seleniumwire_options=proxies
    )
    try:
        driver.get("https://ip.oxylabs.io/")
        return f'\nYour IP is: {driver.find_element(By.CSS_SELECTOR, "pre").text}'
    finally:
        driver.quit()


if __name__ == '__main__':
    print(execute_driver())

Java setup

Prerequisites

1. Java Development Kit (JDK): Version 8 or higher (find newest version here).
2. Build Tool: Apache Maven (available here).
3. Java IDE: Any IDE or CLI supporting Maven.
4. Browser: Google Chrome installed locally (available here).

Initialize a standard Maven project in your preferred IDE or CLI before adding dependencies. After installing, you can verify your Java and Maven installations using the following lines:

java -version

mvn -v

1

Create your project

Select “New Project”, fill in the required details, and select the build system as Maven:

2

Add dependencies

Add the following dependencies to your project's pom.xml file to include Selenium WebDriver, BrowserMob Proxy (for HTTP basic authentication), and WebDriverManager:

<dependencies>
   <!-- https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java -->
   <dependency>
       <groupId>org.seleniumhq.selenium</groupId>
       <artifactId>selenium-java</artifactId>
       <version>4.11.0</version>
   </dependency>
   <!-- https://mvnrepository.com/artifact/net.lightbody.bmp/browsermob-core -->
   <dependency>
       <groupId>net.lightbody.bmp</groupId>
       <artifactId>browsermob-core</artifactId>
       <version>2.1.5</version>
   </dependency>
   <dependency>
       <groupId>org.slf4j</groupId>
       <artifactId>slf4j-simple</artifactId>
       <version>1.7.32</version>
   </dependency>
   <!-- https://mvnrepository.com/artifact/io.github.bonigarcia/webdrivermanager -->
   <dependency>
       <groupId>io.github.bonigarcia</groupId>
       <artifactId>webdrivermanager</artifactId>
       <version>5.5.2</version>
   </dependency>
   <!-- https://mvnrepository.com/artifact/com.google.guava/guava -->
   <dependency>
       <groupId>com.google.guava</groupId>
       <artifactId>guava</artifactId>
       <version>32.1.2-jre</version>
   </dependency>

</dependencies>

3

Add source code

Download the pre-configured proxy wrapper classes from the Oxylabs Selenium Java Repository and add them to your project's src/main/java directory:

• ProxySetup.java: Stores your proxy endpoint parameters and account credentials.
• ProxyHelper.java: Manages BrowserMobProxyServer initialization, basic authentication, and ChromeDriver options.
• ProxyDemo.java: Contains sample execution logic for standard and country-targeted proxy requests.

4

Configure proxies

Open ProxySetup.java and update the proxy details according to your chosen Oxylabs proxy type:

• Residential & Mobile Proxies
• Datacenter Proxies
• Dedicated Datacenter Proxies (Enterprise)
• Dedicated Datacenter Proxies (Self-service)
• ISP Proxies
• Dedicated ISP Proxies

Residential & Mobile Proxies

final class ProxySetup {
    static final String ENDPOINT = "pr.oxylabs.io:7777"; //host:port
    static final String USERNAME = "customer-USERNAME";
    static final String PASSWORD = "PASSWORD";
}

Host: pr.oxylabs.io

Port: 7777

Username: customer-USERNAME

Password: PASSWORD

Note: Don't forget to add customer- prefix to your username.

You may also use additional parameters with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the Residential Proxies documentation to learn more.

Datacenter Proxies

final class ProxySetup {
    static final String ENDPOINT = "dc.oxylabs.io:8001"; //host:port
    static final String USERNAME = "user-USERNAME";
    static final String PASSWORD = "PASSWORD";
}

Host: dc.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

Note: Don't forget to add user- prefix to your username.

Pay-per-IP subscription

The port is the sequential number assigned to an IP address from the proxy list. Thus, port 8001 uses the first IP address from your list. You may also enable proxy IP rotation by setting the port to 8000.

Furthermore, you can specify the geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.

Pay-per-traffic subscription

The port 8001 picks a random IP address but stays consistent during a session. Alternatively, you can rotate proxy IPs with each request by using port 8000.

If you want to use a specific geo-location, for example, the US, set the Proxy username to user-USERNAME-country-US.

Dedicated Datacenter Proxies (Enterprise)

final class ProxySetup {
    static final String ENDPOINT = "1.2.3.4:60000"; //host:port
    static final String USERNAME = "USERNAME";
    static final String PASSWORD = "PASSWORD";
}

Host: 1.2.3.4 (IP address from your proxy list)

Port: 60000 (HTTP), 1180 (SOCKS5)

Username: USERNAME

Password: PASSWORD

For Enterprise Dedicated Datacenter Proxies (purchased through sales team), you’ll have to choose an IP address from the acquired proxy list.

Dedicated Datacenter Proxies (Self-service)

final class ProxySetup {
    static final String ENDPOINT = "ddc.oxylabs.io:8001"; //host:port
    static final String USERNAME = "user-USERNAME";
    static final String PASSWORD = "PASSWORD";
}

Host: ddc.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

Note: Don't forget to add user- prefix to your username.

For Self-Service Dedicated Datacenter Proxies (purchased through Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

ISP Proxies

final class ProxySetup {
    static final String ENDPOINT = "isp.oxylabs.io:8001"; //host:port
    static final String USERNAME = "user-USERNAME";
    static final String PASSWORD = "PASSWORD";
}

Host: isp.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

Note: Don't forget to add user- prefix to your username.

With ISP Proxies, the port is assigned to a specific IP address and its location. Hence, port 8001 will always pick the first IP from your proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

Dedicated ISP Proxies

final class ProxySetup {
    static final String ENDPOINT = "disp.oxylabs.io:8001"; //host:port
    static final String USERNAME = "user-USERNAME";
    static final String PASSWORD = "PASSWORD";
}

Host: disp.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

Note: Don't forget to add user- prefix to your username.

You will need to choose the port assigned to an IP address from the purchased proxy list, which you can find on the Oxylabs dashboard. The 8001 port will pick the first IP address from your list for all requests. Use port 8000 for automatic proxy IP rotation.

5

Execute the integration script

Execute ProxyDemo.java directly within your IDE, or compile and run the packaged JAR file using Maven via the terminal:

mvn clean package
java -cp target/oxylabs-selenium-jar-with-dependencies.jar ProxyDemo

Upon execution, ProxyDemo initializes the driver, routes traffic through the specified Oxylabs endpoint via BrowserMob, and prints the resolved exit IP address.

However, you may need to install proper certificates to enable SSL support and avoid certificate-related warnings covered in the next step.

6

SSL Certificate Handling (optional)

The code uses BrowserMob Proxy, which supports full MITM. However, you may still see invalid certificate warnings.

Programmatic Bypass (Recommended)

Pass --ignore-certificate-errors via ChromeOptions in ProxyHelper.java to bypass SSL validation during automated execution.

Root Certificate Installation

Import the BrowserMob root certificate (ca-certificate-rsa.cer) into your operating system's trust store

• macOS: Drag ca-certificate-rsa.cer into Keychain Access > System > Certificates, right-click, and select Always Trust.
• Windows: Double-click ca-certificate-rsa.cer, select Install Certificate, and set the import destination to Trusted Root Certification Authorities.

If you want to learn more about web scraping with Selenium, read our blog post.

Find the original Selenium integration blog post here.