FoxyProxy setup (Firefox, Chrome, Edge)

Published: 4 October 2026 · 7 min read

What you need before you start

Get these four values from your Roam dashboard and keep that tab open.

Field	Value
Hostname	gw.roamproxy.com
Port	41080
Username	generated in the dashboard
Password	generated in the dashboard

FoxyProxy is free and open source, and the same extension runs in Firefox and in Chrome-based browsers (Chrome, Edge, Brave). Install it from Firefox Add-ons or the Chrome Web Store. This guide follows FoxyProxy 9.x; the menu names are the same in both browsers.

Step 1 — Add Roam as a proxy

1. Click the FoxyProxy icon in the toolbar, then Options, and open the Proxies tab.
2. Click Add. A new proxy card opens.
3. Title: anything you will recognise, for example Roam US.
4. Hostname: gw.roamproxy.com — the hostname only, no http:// and no port.
5. Type: HTTP. Port: 41080.
6. Username and Password: paste them from the dashboard.
7. Country is only a label with a flag for the popup menu. It does not choose the exit country; the username does (next section).
8. Click Save at the bottom of the page.

On Firefox, if you want the proxy to work in private windows too, allow the extension in private browsing (Add-ons and themes → FoxyProxy → Run in Private Windows). FoxyProxy shows a warning in Options until you do. In Chrome the equivalent switch is Allow in Incognito on the extension's details page.

Step 2 — Choose the country and keep one IP

Exit location and IP behaviour are set in the username, not in FoxyProxy:

• Country: append -country-us (or any two-letter ISO code) to your username.
• Keep the same IP: also append -session- plus any label, for example -session-shop1. Every request with that username leaves from the same residential IP for as long as the session lasts.

For a browser, use a session. One page load is dozens of requests, and a site that sees them arrive from different IPs within a second treats that as a bot. A username like roamXXXX-country-us-session-shop1 gives you one US residential IP for the whole browsing session. When you want a fresh IP, change the label to shop2 and save.

Step 3 — Turn it on from the toolbar

Click the FoxyProxy icon. The popup has three kinds of choices:

• Disable: FoxyProxy does nothing; the browser uses its normal connection.
• Roam US (your proxy's title): every website goes through Roam.
• Proxy by Patterns: only sites that match your rules go through Roam; everything else stays direct. See step 4.

Select Roam US for now and load a page. You should not see a password prompt. FoxyProxy answers the proxy's 407 challenge with the saved credentials. If a browser login box appears for gw.roamproxy.com, the credentials FoxyProxy sent were rejected; re-copy them from the dashboard, watching for a trailing space.

Step 4 — Send only some sites through Roam

This is what FoxyProxy is for, and what the browser's own proxy settings cannot do.

1. In Options → Proxies, open the Roam card and find the Proxy by Patterns section under the fields. Click ✚ to add a pattern row.
2. Set the row to Include and Match, give it a title, and enter the site, for example *://*.example.com/*. That covers example.com and all of its subdomains, over HTTP and HTTPS.
3. Add one row per site, then Save.
4. In the toolbar popup, choose Proxy by Patterns.

Proxies are checked from top to bottom. For each proxy, an Exclude row that matches skips it, and an Include row that matches uses it; if nothing matches, FoxyProxy moves to the next proxy and finally goes direct. Use the Tester tab to paste a URL and see which proxy it would use before you rely on a rule.

Remember that a site often loads its login page, images or API from other domains. If a site half-works under patterns but works fully in Roam US mode, open the browser's developer tools → Network, find the other domains it calls, and add them as Include rows too.

More than one country: give each entry its own hostname

The natural next step is to duplicate the card, call it Roam DE and change the username to -country-de. With the same hostname and port this does not work. FoxyProxy stores credentials by hostname:port, so two entries for gw.roamproxy.com:41080 share one set of credentials, and the last one saved wins. Browsers also keep the proxy connection open and reuse it, so even when the right username is sent, an already-open tunnel keeps the old country.

The fix is to give each entry a different hostname that points to the same gateway. Roam answers on any name under gw.roamproxy.com:

Title	Hostname	Username
Roam US	us.gw.roamproxy.com	roamXXXX-country-us-session-a1
Roam DE	de.gw.roamproxy.com	roamXXXX-country-de-session-a1
Roam JP	jp.gw.roamproxy.com	roamXXXX-country-jp-session-a1

Same port 41080, same password. Each entry now has its own credentials and its own connections, and switching in the popup changes the country on the next page load. We tested exactly this table through the gateway: each hostname exited in its own country.

Verify (properly)

FoxyProxy's popup has an IP button that shows the current exit address. Also open the IP check and confirm a Roam IP in the country you chose, then open two or three sites you actually use; an IP check is one small request and can succeed when real browsing does not. If the IP changed but sites time out, go to connected but not working.

Then run the WebRTC leak test. WebRTC can reveal your real address even while every normal request uses the proxy. FoxyProxy can fix this for you: Options → Limit WebRTC → Disable Non-Proxied, then Save. Video calls may stop working in that browser while it is set.

If you only need to switch countries

FoxyProxy is the right tool when you want per-site rules, or when you also use other proxies. If all you want is "browse from this country, with a fixed or rotating IP", the Roam browser extension does it in one popup: pick a country, toggle on, sign in once. It handles the per-change hostname trick above for you.

If your network cannot reach the gateway

A browser extension cannot chain through another hop. If your network blocks direct connections to gw.roamproxy.com:41080, run a system-level client that supports chaining, such as Clash with dialer-proxy, and point FoxyProxy at that local client instead.

Plans and what a session costs

Rotating residential traffic is billed at $2/GB with no monthly minimum, and pattern mode keeps the bill small because only the sites you choose use the proxy. If you need one address that stays the same for weeks, such as an account that reacts badly to a changing IP, a static residential IP is $4/IP/month; enter it in FoxyProxy the same way, with its own hostname, port and credentials. New accounts get 50MB of trial traffic after email verification, plus 250MB more on the first top-up (300MB total), which is enough to finish this tutorial and check the exit IP on your target sites.

FAQ

FoxyProxy is on, but the browser keeps asking for a proxy password.

FoxyProxy did send credentials and the gateway rejected them. Re-copy the username and password from the dashboard; a trailing space from copy-and-paste is the usual cause. If you just changed the username, also check that two entries do not share the same hostname and port, because the last one saved overwrites the credentials of the other.

Can I use SOCKS5 in FoxyProxy?

In Firefox, yes: choose SOCKS5, enter the same hostname, port and credentials, and leave Proxy DNS on. In Chrome, Edge and Brave, no. Chromium cannot authenticate to a SOCKS5 proxy, so use the HTTP type there. For browsing, HTTP and SOCKS5 give the same result with Roam.

I switched from the US entry to the DE entry and the IP is still American.

Both entries use the same hostname. The browser reused the open connection and FoxyProxy reused one set of credentials. Give each country its own hostname (us.gw.roamproxy.com, de.gw.roamproxy.com) as shown in the table above, save, and reload.

Does Proxy by Patterns save traffic?

Yes. Only requests that match an Include rule go through Roam, so you pay only for those sites. Everything else (video, updates, your normal browsing) stays on your own connection.

FoxyProxy or the Roam extension?

Use FoxyProxy for per-site rules or when you mix several proxy providers. Use the Roam extension when you just want to pick a country and browse; it needs no manual hostnames or usernames.

Roam is the exit-IP layer for this setup: rotating residential at $2/GB, static residential at $4/IP/month, no monthly minimum. Create an account and get 50MB of trial traffic on signup, plus 250MB on your first top-up — enough to finish this tutorial and check the exit IP on the sites you care about.