Oxy® Proxy Extension for Chrome
Oxy® Proxy Extension for Chrome setup with Oxylabs Residential Proxies – a quick integration guide. Free proxy manager that works with any provider.
Oxy® Proxy Extension is a proxy management extension for Chrome. It's free and works with any proxy provider of your choice.
This quick guide shows how to integrate Oxylabs Residential Proxies.
Setup
Download and click the extension icon to open the application.
Click the +Add new proxy button.
A new tab will open up where you can set up your proxy profile.
Fill in the details as follows:
Name
Project name
Protocol
HTTP or HTTPS
Domain
pr.oxylabs.io
Port
7777
Username
customer-USERNAME
Password
PASSWORD
Make sure to add the customer- part to your username.
Click Save changes.
Open the extension as shown in the first step and click Connect.
That's it. You're now using proxies with automatically rotating IP addresses.
Geo-location settings
Residential Proxies give you fine control over geo-location (country, state, city, etc.) when you modify the host, port, or username with additional parameters. Check out the examples below:
Host: us-pr.oxylabs.io
Port: 10000
Username: customer-USERNAME-cc-DE
Username: customer-USERNAME-cc-US-city-los_angeles
Username: customer-USERNAME-st-us_california
Username: customer-USERNAME-cn-NA
Username: customer-USERNAME-cc-US-postalcode-90012
Username: customer-USERNAME-ASN-21928
Static sessions
Sticky country-specific entries allow you use the same IP address for up to 10 minutes. For example, if you enter us-pr.oxylabs.io as the Domain and 10001 as the Port, you’ll receive the US exit node with a sticky session.
Additionally, you can control your sessions by assigning a random alphanumeric string to the sessid- parameter. This parameter must be appended to your username, for example, customer-USERNAME-sessid-123:
With this approach, you can use the same IP address for up to 1440 minutes (24 hours) by adding the sesstime parameter, for example: customer-USERNAME-sessid-123-sesstime-1440.
After saving the changes, open the extension window and connect to the newly created proxy.
Global bypass list
If you don't want to use proxies when accessing specific websites, you can add them to the bypass list. Open the extension, click Manage proxies, and then open the Global Bypass List.
For example, if you want to skip using proxies for https://ip.oxylabs.io/, you should enter the address like this: https://ip.oxylabs.io or ip.oxylabs.io. Once you visit this site, you should see your regular IP address instead of a proxy IP.
After saving the changes, disconnect and reconnect the proxy to enable the bypass list.
Common errors
Use the troubleshooting steps outlined below to fix common extension errors when using Oxylabs or other providers' proxies.
Proxies not connecting
Try disconnecting and re-connecting your proxies in the extension. If the issue persists, move on to the next step below.
Incorrect proxy credentials
Verify the proxy username and password you've entered are correct and match the credentials assigned by your proxy provider.
For Oxylabs Residential Proxies, ensure you're using the proxy user's username and password you've created in the Oxylabs dashboard. You can always edit these credentials in the dashboard by going to My Products → Datacenter Proxies → Users.
Invalid username without appending customer-
Oxylabs Residential Proxies require you to append the customer- string to your proxy user's username. For example, if your username is john_TFTdL, then you must enter your username as customer-john_TFTdL.
Invalid proxy domain or port
Make sure you're using a valid proxy domain and port number as assigned by your proxy provider.
A valid domain address for Oxylabs Residential Proxies is pr.oxylabs.io and port 7777. Check the valid ports in our documentation by visiting the country-specific entry points and sticky entry points pages.
Proxy port out of range
Verify you've entered a proxy port that isn't out of range. For Oxylabs Residential Proxies, refer to these lists of country-specific entry points and sticky entry points.
Extension not working
If the extension is not working for some reason, try uninstalling and re-installing it through the Chrome web store or browser settings.
Disable third-party VPN
Turn off a third-party Virtual Private Network (VPN) if you're using it. It may conflict with the Oxy® Proxy Extension.
This guide is also available for Datacenter Proxies, ISP Proxies, Mobile Proxies, Enterprise and Self-Service Dedicated Datacenter Proxies.
You can also check out our free Oxy® Proxy Manager app for Android. It allows you to easily add and manage proxies as well as switch between multiple IPs with a simple one-click connection.
Last updated
Was this helpful?