Residential Proxy Setup: Step-by-Step Config Guide

By the end of this 10-minute guide, your residential proxy setup will be fully functional — routing traffic through carrier-grade NAT IPs assigned by AT&T or T-Mobile. You'll configure authentication, choose the right protocol and port, verify your exit IP, and trigger your first rotation. Every step includes exact values you can copy-paste.

ProxyPanel's mobile proxies use CGNAT-assigned IPs, which carry higher trust scores than typical residential or datacenter addresses because they share IP pools with millions of real phone users. That distinction matters when you're managing 30 Instagram accounts or scraping Amazon listings across 50 cities.

Want to explore before committing? Browse all 174 US locations and review the live API reference — no account required.

Before You Start

• A ProxyPanel account with an active plan (the $1 trial works for every step below)
• Your proxy credentials: username, password, and gatewayip — found in the ProxyPanel dashboard after purchase
• One of the following: a terminal with curl, an anti-detect browser (Multilogin, GoLogin, AdsPower, Dolphin Anty, Octo Browser), or a scraping framework (Selenium, Playwright, Scrapy)
• Internet access on the machine that will send proxied requests

[IMAGE: ProxyPanel dashboard showing proxy credentials (username, password, gateway host) — screenshot of credential panel]

Step 1: Choose Your Protocol and Port

ProxyPanel supports two proxy protocols:

Protocol	Port	Best For
HTTP	8083	Browser profiles, general web scraping, API requests
SOCKS5	9093	UDP traffic, anti-detect browsers needing SOCKS, Playwright

Pick HTTP if your tool doesn't specify — it's the most universally supported. Use SOCKS5 when your anti-detect browser session requires it or when you need lower-level socket handling.

Step 2: Select Your Authentication Method

ProxyPanel offers two auth methods. Use whichever fits your workflow:

Username & Password

Enter these values in your tool's proxy settings:

• Host: gatewayip
• Port: 8083 (HTTP) or 9093 (SOCKS5)
• Username: your ProxyPanel username
• Password: your ProxyPanel password

IP Whitelisting

If your tool doesn't support proxy authentication (some scraping scripts, for example), whitelist your machine's public IP in the ProxyPanel dashboard under Settings → IP Whitelist. Once whitelisted, connect to gatewayip:8083 or gatewayip:9093 without credentials.

Step 3: Configure Your Proxy in cURL (Quick Test)

Before touching browser profiles or scraping frameworks, confirm connectivity from the terminal:

curl -x http://USER:PASS@gatewayip:8083 https://api.ipify.org

Replace USER and PASS with your actual credentials. This command routes the request through the HTTP proxy endpoint and returns your exit IP.

Step 4: Configure an Anti-Detect Browser Profile

Using Multilogin as the example (the flow is nearly identical in GoLogin, AdsPower, Dolphin Anty, and Octo Browser):

1. Open Multilogin and click Create Profile
2. Navigate to Proxy → Edit proxy settings
3. Set Connection type to HTTP or SOCKS5
4. Enter gatewayip in the Host field
5. Enter 8083 (HTTP) or 9093 (SOCKS5) in the Port field
6. Fill in your Username and Password
7. Click Check Proxy — the tool should return a US-based IP
8. Save the profile and launch it

[IMAGE: Multilogin proxy configuration dialog with gatewayip, port 8083, and credential fields filled — anti-detect browser proxy config screenshot]

Step 5: Configure Selenium or Playwright

For Selenium with Python and the HTTP proxy endpoint:

from selenium import webdriver

proxy = "http://USER:PASS@gatewayip:8083"
options = webdriver.ChromeOptions()
options.add_argument(f"--proxy-server={proxy}")
driver = webdriver.Chrome(options=options)
driver.get("https://api.ipify.org")
print(driver.page_source)
driver.quit()

For Playwright, pass the proxy at browser launch:

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gatewayip:8083",
        "username": "USER",
        "password": "PASS"
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org")
    print(page.content())
    browser.close()

Step 6: Trigger an IP Rotation

ProxyPanel automatically rotates IPs with a minimum interval of 180 seconds. To force a rotation on demand, hit the IP change URL provided in your dashboard:

curl "https://gatewayip/api/changeIP?user=USER&pass=PASS"

Smart rotation locks your session to the same city and carrier, so your new IP still geolocates to the same metro — critical for session persistence when running multi-account workflows.

Ready to test this with your actual stack? Grab the $1 trial and run your own benchmarks across any of the 174 city endpoints.

Step 7: Automate Rotation via the REST API

For scraping pipelines that need programmatic control, ProxyPanel's REST API documentation covers endpoints for IP rotation, current IP retrieval, and session management. A typical automation loop:

1. Send request batch through gatewayip:8083
2. Call the IP change endpoint
3. Wait 180 seconds (the minimum rotation interval)
4. Repeat

[IMAGE: Diagram of automated scraping loop — request batch → IP change API call → 180s cooldown → next batch]

Verifying It Works

Run this command twice, with a manual IP change in between:

$ curl -x http://USER:PASS@gatewayip:8083 https://api.ipify.org
104.28.207.56

$ curl "https://gatewayip/api/changeIP?user=USER&pass=PASS"
{"success":true,"message":"IP changed successfully","new_ip":"172.58.31.184"}

$ curl -x http://USER:PASS@gatewayip:8083 https://api.ipify.org
172.58.31.184

You should see two different US-based IPs. Both will belong to AT&T or T-Mobile CGNAT ranges. If the IP didn't change, wait at least 180 seconds and retry — the minimum rotation interval must elapse.

Common Mistakes

• Symptom: 407 Proxy Authentication Required — Fix: Double-check your username and password in the proxy config. If using IP whitelisting, confirm your current public IP matches the one saved in the dashboard.
• Symptom: Connection timeout on port 8083 or 9093 — Fix: Ensure your firewall or corporate network isn't blocking outbound traffic on those ports. Test with telnet gatewayip 8083.
• Symptom: IP doesn't change after calling the rotation URL — Fix: Respect the 180-second minimum rotation interval. Calling the endpoint faster than that returns the same IP.
• Symptom: Anti-detect browser shows ERR_PROXY_CONNECTION_FAILED — Fix: Verify you selected the correct protocol. Setting the browser to SOCKS5 but entering port 8083 (the HTTP port) will fail. Use 9093 for SOCKS5.

Pro Tips

• Lock city-level geo: Smart rotation keeps your session in the same city and on the same carrier. Use this when a platform checks for geographic consistency across requests.
• Use SOCKS5 for fingerprint-sensitive work: SOCKS5 on port 9093 handles DNS resolution server-side, reducing DNS leak risk in anti-detect browser sessions.
• Batch your scraping windows: Since every ProxyPanel plan includes unlimited data, schedule heavy scrapes during off-peak hours (2–6 AM ET) for faster response times on the carrier network.
• Rotate per task, not per request: For multi-account management, assign one sticky session per account profile. Rotate only when switching accounts to maintain session persistence and avoid IP cycling fingerprints.
• Monitor via API: Use the REST API to log every IP change with a timestamp. This creates an audit trail if a platform flags activity — you can prove non-overlapping sessions.

Frequently Asked Questions

Why am I getting 407 Proxy Authentication Required even though my credentials are correct?

Copy the credentials directly from the ProxyPanel dashboard — trailing spaces or special characters in the password can cause 407 errors. If the issue persists, switch to IP whitelisting as a diagnostic step. Check the help center for credential-reset instructions.

Does this residential proxy setup work on macOS, Linux, and Windows?

Yes. The curl commands work identically on all three. Anti-detect browsers like Multilogin and GoLogin are cross-platform, and Selenium/Playwright configs are OS-agnostic. The proxy endpoint gatewayip:8083 behaves the same regardless of client OS.

What if the IP change API call returns {"success":false}?

This typically means you haven't waited the full 180-second rotation interval. Track the timestamp of your last successful rotation and add a sleep(180) in your script before the next call.

Can I revert to a previous IP if the new one gets flagged?

No — CGNAT IPs are dynamically assigned by the carrier and cannot be recalled. However, smart rotation guarantees the replacement IP stays in the same city and on the same carrier, so geographic consistency is preserved.

How do I verify the proxy is using a mobile carrier IP and not a datacenter IP?

Run curl -x http://USER:PASS@gatewayip:8083 https://ipinfo.io and check the "org" field. You should see AS20057 ATT-MOBILITY-LLC-AS20057 or AS21928 T-Mobile USA, Inc. — confirming a genuine CGNAT mobile IP.

Your residential proxy setup is complete. You've configured authentication, connected through HTTP or SOCKS5, verified your exit IP against a real carrier range, and triggered on-demand rotation. Every ProxyPanel plan unlocks all 174 US locations with unlimited bandwidth — and the $1 trial gives you a full hour to stress-test the setup with your actual workload before upgrading to a weekly or monthly plan.

---

Useful Links

• View Pricing Plans
• Proxy Documentation
• Help Center

Related Articles

• IP Whitelisting Authentication
• IP Rotation
• IP Blocking