Does Camoufox work with my existing Playwright code?

Yes. Camoufox returns ordinary Playwright browser, context and page objects, so only the launch line changes. Its proxy setting uses the same format as Playwright too.

Do I need geoip=True with a proxy?

Yes, whenever you use a proxy. Without it the browser keeps your machine's timezone and locale while its traffic leaves from somewhere else, so a localized page can serve a different variant from the one a visitor in that country gets. It needs the camoufox[geoip] extra.

Should I use rotating or sticky proxies with Camoufox?

Sticky. geoip reads the exit IP once at launch, so the IP has to stay the same for the whole run. Rotation on every request is better kept for plain HTTP collection outside a browser.

Can each Camoufox context use a different proxy?

Yes. NewContext(browser, proxy=...) gives a context its own proxy and identity, and Camoufox looks up that context's WebRTC IP and timezone from its exit IP. Give each context its own Evomi session ID.

Which Evomi proxy fits Camoufox?

Residential, for country, region and city targeting across 195+ countries and sessions you control. Static Residential suits a job that must keep one US address for weeks. Datacenter is enough when the target is your own staging site.

What is Camoufox used for?

Testing how sites render in different markets, verifying ads and localized prices, collecting public data within a site's terms, and browser fingerprinting research. A different browser or IP does not change what a site's terms allow, so the same rules apply as with any other browser.

Camoufox Proxy Setup with geoip and Sticky IPs

Give Camoufox an Evomi residential proxy, let geoip set timezone, locale and WebRTC from the exit IP, and hold that IP for the whole run so the location you test is the one the site sees.

Try for Free View Pricing

Money Back Guarantee Superior Support

Trusted by brands worldwide

Setup

Pass an Evomi proxy to Camoufox

Camoufox is a Firefox-based browser driven through Playwright, so it takes a proxy the way Playwright does: a dictionary with server, username and password. Keep the credentials in their own fields rather than inside the server URL.

from camoufox.sync_api import Camoufox

proxy = {
    "server": "http://rp.evomi.com:1000",
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD_country-DE_session-cfx01de",
}

with Camoufox(proxy=proxy, geoip=True) as browser:
    page = browser.new_page()
    page.goto("https://ip.evomi.com/s")
    print(page.inner_text("body"))

Install it with pip install -U "camoufox[geoip]" and run camoufox fetch once. The geoip extra is what makes geoip=True work. The HTTP endpoint on port 1000 is the simplest choice and carries HTTPS sites as well. The script prints the exit IP, which should sit in the country named in the password.

geoip

Why geoip needs a sticky session

With geoip=True, Camoufox looks up the proxy's exit IP as the browser launches and sets timezone, locale, geolocation and the WebRTC address to match it. That lookup happens once. Evomi Residential gives every request a new IP by default, so without a session parameter the browser would describe one city while its traffic arrived from many.

Always add a session to the password, with an ID of 6 to 10 letters and digits:

_session-ID holds the IP for 30 minutes, or longer with _lifetime- up to 1440 minutes. Set the lifetime longer than the run.
_hardsession-ID keeps the same IP for as long as possible, with no lifetime to set.
_lockedsession-ID fails rather than switch IP. For a test whose result depends on location, a clear failure beats a silent change.

Start each launch with a new session ID. The new browser then gets a new IP and a fresh geoip lookup that agrees with it.

Contexts

Several markets in one Camoufox run

Localization QA often means loading the same page in a few markets. NewContext gives each browser context its own identity and its own proxy, and Camoufox looks up that context's WebRTC IP and timezone from its exit IP. Evomi covers 195+ countries, so the market is just a parameter:

from camoufox.sync_api import Camoufox, NewContext

USER, PASS = "YOUR_USERNAME", "YOUR_PASSWORD"

def evomi(country, sid):
    return {
        "server": "http://rp.evomi.com:1000",
        "username": USER,
        "password": f"{PASS}_country-{country}_session-{sid}",
    }

with Camoufox(headless=True) as browser:
    for country in ["DE", "FR", "US"]:
        proxy = evomi(country, f"qa{country}01")
        ctx = NewContext(browser, proxy=proxy)
        page = ctx.new_page()
        page.goto("https://example.com/pricing")
        page.screenshot(path=f"pricing-{country}.png")

To keep cookies between runs, for instance for a staging login you own, launch with persistent_context=True and a user_data_dir, and pair it with a _hardsession. On per-GB plans, block_images=True cuts the bytes a run transfers; leave it off when the images are what you are checking.

Troubleshooting

Common Camoufox proxy errors

InvalidIP: Failed to get IP address at launch. geoip could not reach any of its public IP lookup services through the proxy, so the browser did not start. Check the username, password and port first. If the proxy works but the lookup does not, find the exit IP yourself and pass it as geoip="203.0.113.7".
Timezone or locale points at the wrong country. Camoufox places the IP with its own GeoIP database, set by geoip_db, while Evomi picked the IP using its database, set by _geosource- (ip-api by default, or maxmind). When the two disagree about an address, geoip follows Camoufox's. Try the other Evomi source, or pick a different Camoufox database with camoufox set --geoip, and confirm the result at https://ip.evomi.com/s.
Error 407. The proxy rejected the credentials. Every parameter in the password starts with an underscore; a stray space or a missing underscore is the usual cause.
Error 412. The targeting cannot be met, for example a city with no available IPs or a _lifetime above 1440.
The location drifts after half an hour. A plain _session expires after 30 minutes. Raise _lifetime or switch to _hardsession.
Launch fails after a Playwright upgrade. The camoufox package requires Playwright below 1.63. Give it its own virtual environment so another project cannot upgrade Playwright under it.

The exit IP drives the identity

geoip turns the proxy's exit IP into timezone, locale, geolocation and WebRTC settings, which makes the IP the one input worth getting right.

FAQ

Camoufox proxy questions

Pass a Playwright-style dictionary to Camoufox(): server http://rp.evomi.com:1000, with your Evomi username and password in their own fields. Add geoip=True so timezone, locale and geolocation follow the proxy IP, and a session parameter in the password so that IP stays fixed for the run.