ProxlyBack to home
Dashboard
All setup guides

Proxies in
Puppeteer.

Configure the browser proxy and authentication.

HTTPNode.js

Get your connection details

Open your Residential or Datacenter access in the dashboard, then its configuration tab. Select the protocol shown here, your country and session settings.

host
Server address
port
Port for this protocol
login
Proxy username
password
Proxy password

Copy the fields separately. Proxy credentials are different from your Proxly account login. After changing the location, copy the updated proxy username again.

Open your connection

Connect the app

  1. Install Puppeteer: npm install puppeteer.

  2. Set PROXLY_PROXY_SERVER (http://host:port), PROXLY_PROXY_USERNAME and PROXLY_PROXY_PASSWORD using the dashboard's HTTP details.

  3. Save the example as proxy-test.mjs and run node proxy-test.mjs.

Connection example
import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
  args: [`--proxy-server=${process.env.PROXLY_PROXY_SERVER}`],
});
try {
  const page = await browser.newPage();
  await page.authenticate({
    username: process.env.PROXLY_PROXY_USERNAME,
    password: process.env.PROXLY_PROXY_PASSWORD,
  });
  await page.goto("https://api.ipify.org?format=json");
  console.log(await page.$eval("body", el => el.innerText));
} finally {
  await browser.close();
}

Set HTTP authentication before the first navigation. Authenticated SOCKS5 in Chromium is unsuitable for this example.

Test the connection

The terminal output shows the IP of the Puppeteer request.

Turn the proxy off

Remove --proxy-server and page.authenticate, then restart the browser.

If the connection fails

Authentication error

Recopy the proxy credentials. Include the full username with location and session settings. HTTP status 407 means proxy authentication was not accepted.

Connection timeout

Check the dashboard host and the port for the selected protocol. Make sure the access has remaining data. Use HTTP for Chromium with username and password.

The IP did not change

Check the IP inside the configured app or browser profile. Make sure the test site is not excluded from the proxy. Telegram does not change your regular browser IP.

Still having trouble? Contact support

App documentation:PuppeteerChromium