Tooling & Integrations

Using a proxy with Selenium and Puppeteer

Pass proxy settings to headless browsers correctly, including authenticated SOCKS5.

On this page
  1. 01Puppeteer
  2. 02Selenium

Headless browsers do not read system proxy settings. Pass the proxy explicitly and verify the exit IP inside the browser context.

01Puppeteer

puppeteer.js
const browser = await puppeteer.launch({
  args: ['--proxy-server=socks5://proxy.ipfast.net:1080']
})
const page = await browser.newPage()
await page.authenticate({ username: 'user_xxxxxx', password: 'your_password' })
await page.goto('https://ipinfo.io/ip')

02Selenium

Chrome does not support authenticated SOCKS5 natively. Use a local proxy relay, or switch to HTTP with credentials and load an extension — the HTTP path is usually simpler.

Common mistakeForgetting page.authenticate() results in an ERR_PROXY_AUTH_UNSUPPORTED error even though the credentials are correct.

FAQFrequently asked

How soon can I use an IP after purchase?

Lines are generated in about 1–3 minutes. Check "My IPs" in the console for the assigned address.

Which protocols are supported? Which one should I use?

Both HTTP and SOCKS5 are supported. For anti-detect browsers and desktop clients, SOCKS5 has better compatibility.

What happens when a line expires?

Forwarding stops immediately. Enable expiry reminders and renew in advance — the IP stays the same after renewal.

Can I use the same line for several accounts?

Technically yes, but it is not recommended. Sharing one IP increases the risk of linking accounts. Use a dedicated static IP per account or profile.

Do you support IP whitelisting?

Yes. You can authenticate by username and password or by whitelisting your egress IP. Whitelisting suits servers with a fixed IP.

Was this article helpful?
I

IPFAST Tech Team

We build and operate IPFAST residential proxy infrastructure. Every guide here is tested in-house and kept in sync with the product.

More guides

Related articles

Help Center
Newsletter

Subscribe to IPFAST updates

New tutorials, product updates, and industry insights — about once a month. Unsubscribe anytime.

By submitting you agree to the Privacy Policy
Start free trial See pricing