# BitBrowser Proxy Setup: Add, Check and Fix > BitBrowser proxy setup step by step: the Proxy fields, HTTP or Socks5 to match the port, Check Proxy, Batch Add with http:// lines and a fix for each error. [Home](https://quanticdata.io/)/[Blog](https://quanticdata.io/blog/)/BitBrowser Proxy Setup: Add, Check and Fix # How to set up a proxy in BitBrowser: add it, check it, fix the errors ProxiesOct 23, 2026·11 min read·By [Aldo Morese](https://quanticdata.io/about/), founder of QuanticData Setting up a proxy in a BitBrowser profile in four steps: generate a sticky line in the QuanticData endpoint generator, paste it as host:port:user:pass into the Host field with Type HTTP on port 8080, click Check Proxy for IP, city and time zone, then Confirm and open the profile; the card lists the three things to verify when the check fails. On this page [What you need before you start](/blog/bitbrowser-proxy-setup/#what-you-need-before-you-start) [The fields of BitBrowser's Proxy section](/blog/bitbrowser-proxy-setup/#the-fields-of-bitbrowser-s-proxy-section) [Step by step: add a proxy to a BitBrowser profile](/blog/bitbrowser-proxy-setup/#step-by-step-add-a-proxy-to-a-bitbrowser-profile) [One sticky session per profile](/blog/bitbrowser-proxy-setup/#one-sticky-session-per-profile) [Residential Premium, ISP and mobile proxies in BitBrowser](/blog/bitbrowser-proxy-setup/#residential-premium-isp-and-mobile-proxies-in-bitbrowser) [Adding proxies to many profiles at once](/blog/bitbrowser-proxy-setup/#adding-proxies-to-many-profiles-at-once) [A new IP for a profile](/blog/bitbrowser-proxy-setup/#a-new-ip-for-a-profile) [BitBrowser proxy not working: errors and fixes](/blog/bitbrowser-proxy-setup/#bitbrowser-proxy-not-working-errors-and-fixes) [HTTP or Socks5 in BitBrowser](/blog/bitbrowser-proxy-setup/#http-or-socks5-in-bitbrowser) [Before you run accounts](/blog/bitbrowser-proxy-setup/#before-you-run-accounts) To add a proxy in BitBrowser, open Browser Profiles, click Add (or edit a profile) and go to Proxy. Keep Method on Custom, set Type to HTTP for port 8080 or Socks5 for port 1080, paste host:port:user:pass into Host, click Check Proxy and Confirm. Give every profile its own sticky session. Below: each field, bulk import and a fix for each error. BitBrowser keeps each browser profile apart: its own cookies, its own fingerprint and its own proxy. The proxy decides which IP address and which country the sites see, and BitBrowser takes the profile's time zone and language from that IP. Four values are enough to set it up, and a wrong type or a cut username is behind most failed checks. The field names below are the ones in BitBrowser's own documentation and in its current app, version 7.2.0; the values come from the QuanticData endpoint generator. ## What you need before you start - **BitBrowser installed, with an account.** Its documentation says a new account gets 10 free browser profiles; more profiles need a paid plan. - **A proxy plan.** Residential Premium, ISP or mobile: all three work in BitBrowser, and each has its own section below. - **The four values:** host, port, username and password. In the QuanticData dashboard they are under My proxies, on the plan's page, in the Endpoint generator. **Try it on your own targets.** Every QuanticData account gets $2 of free API usage per month. [Start free — $2/month included](https://quanticdata.io/signup/?utm_source=blog&utm_medium=website&utm_campaign=blog-inline&utm_content=bitbrowser-proxy-setup)[Explore Residential Proxies from $0.80/GB](https://quanticdata.io/residential-proxies/) ## The fields of BitBrowser's Proxy section The Proxy section is the same when you add a profile and when you edit one. This is what each field does and what goes in it with a QuanticData Residential Premium line: | Field | What it does | QuanticData value | | --- | --- | --- | | Method | Custom (you type the proxy), Extract By API (a provider's extraction link) or Proxy Management (a proxy you saved before) | Custom, or Proxy Management for a saved line | | Lookup Channel | The service BitBrowser uses to look up the exit IP when you click Check Proxy | Leave the default | | Type | HTTP, HTTPS, Socks5 or SSH; Direct Connection Mode means no proxy | HTTP for port 8080, Socks5 for port 1080 | | Protocol | IPv4 or IPv6 address of the proxy host | IPv4 | | Host | The proxy address; a whole Host:Port:Username:Password line pasted here is split into the four fields | `residentialpremium.quantumproxies.io` | | Port | The proxy port | `8080` or `1080` | | Username, Password | Optional in BitBrowser, needed for username and password plans | The whole username, with the targeting, and the password | | Refresh Proxy | A refresh URL from providers that change the IP through a link | Leave empty | | UDP | Shown for Socks5: lets WebRTC use UDP traffic | Optional; the steps here leave it off | ## Step by step: add a proxy to a BitBrowser profile Step 1 in the QuanticData dashboard: country, sticky session, protocol and format give the line to paste. 1. **Generate the line.** In the QuanticData dashboard open My proxies, then your plan. In the Endpoint generator choose the Country (and a Region or City if the profile needs one), set Session to Sticky, set Session TTL (minutes) to at least the time the profile stays open, choose the Protocol and keep the Output format on host:port:user:pass. The Preview shows the line. 2. **Open the profile in BitBrowser.** Go to Browser Profiles and click Add for a new profile, or open an existing profile to edit it. Scroll to the Proxy section. 3. **Keep Method on Custom.** Leave Lookup Channel on its default and Protocol on IPv4. 4. **Set Type to match the port.** HTTP for port 8080, Socks5 for port 1080. 5. **Paste the whole line into Host.** BitBrowser splits it into Host, Port, Username and Password. Check that Username holds the full string, with everything after the first dash. 6. **Click Check Proxy.** On the right BitBrowser shows the IP, Country/Region, State/Province, City, Lng/Lat, Timezone and Zip of the exit. The country has to match the `-country-` in the username. 7. **Leave Refresh Proxy empty.** It is for providers that change the IP through a URL; with QuanticData a new IP comes from a new session ID, explained below. 8. **Click Confirm, then Open the profile.** The profile's time zone and language follow the proxy's IP by default. Steps 3 to 8 in BitBrowser, redrawn with our values: the result on the right is a real check of a QuanticData Netherlands line on 23 October 2026. The line from the generator looks like this, with your own username and password in place of USER and PASS: ``` # Type HTTP, pasted into Host residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p01-ttl-60m:PASS # Type Socks5, the same session on the SOCKS5 port residentialpremium.quantumproxies.io:1080:USER-country-nl-sid-p01-ttl-60m:PASS ``` In the username, `-country-nl` picks the exit country, `-sid-p01` names the session and `-ttl-60m` keeps it for 60 minutes. A username cut at the first dash still logs in, but the profile then leaves from a random country on a new IP at every request. ## One sticky session per profile An antidetect profile is meant to look like one person on one connection. A rotating proxy changes IP on every request, which is fine for scraping and wrong for a profile that logs in. A sticky session keeps one IP for as long as the session lives, and the session lives in the username, so the line never changes once it is saved in the profile. ``` # profile 1: Netherlands, one session for a working day residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p01-ttl-480m:PASS # profile 2: same plan, its own session (never reuse p01) residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p02-ttl-480m:PASS # profile 3: Netherlands, open all day residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p03-ttl-1440m:PASS ``` - **A different session ID in every profile.** Two profiles on the same line share one IP, which is what an antidetect browser is there to avoid. - **A lifetime longer than the work.** The generator accepts up to 1440 minutes, a full day. When the session ends, the next request gets a new IP, and a site can see that as a new login location. - **The country in the username.** Without `-country-` the exit can be anywhere, and the profile's time zone will not match what you planned. ## Residential Premium, ISP and mobile proxies in BitBrowser ### Residential Premium Everything above is a Residential Premium setup: one sticky line per profile, with country, region, city or ISP in the username. Premium plans use username and password only, so Username and Password are always filled in. It is the right start for most profiles: home IPs in the country you choose. The plans are on the page for [QuanticData residential proxies](https://quanticdata.io/residential-proxies/). ### ISP ISP plans give fixed IPs, listed on the plan's page under Assigned IPs. Choose HTTP / HTTPS or SOCKS5 above the list and the output format IP:Port:Username:Password, then copy one line per profile and paste it into Host: BitBrowser splits it the same way. Set Type to HTTP for the HTTP / HTTPS list and to Socks5 for the SOCKS5 list. An ISP IP stays the same for the life of the plan, so it suits accounts that should keep one address for months; there is nothing to rotate and Refresh Proxy stays empty. More on the page for [ISP proxies](https://quanticdata.io/isp-proxies/). ### Mobile Mobile plans use the host `mobile.quantumproxies.io` with a Global, USA, EU or Asia gateway, HTTP on port 8080 or SOCKS5 on port 1080, and `-type-mobile` in the username. With Session set to Sticky the line goes into Host exactly like a residential one: ``` mobile.quantumproxies.io:8080:USER-country-nl-type-mobile-sid-p01-ttl-60m:PASS ``` Mobile plans also offer IP whitelist authentication: add your IP in the dashboard, take the host:port list it gives, and leave Username and Password empty in BitBrowser, since both are optional there. For which platforms mobile IPs suit, see [mobile proxies for antidetect browsers](https://quanticdata.io/mobile-proxies/for/antidetect-browsers/); the plans are on the page for [QuanticData mobile proxies](https://quanticdata.io/mobile-proxies/). ## Adding proxies to many profiles at once One line per profile: every generated line has its own session ID. 1. **Make the lines.** In the generator, set Session to Sticky and the Quantity you need, ten by default, then Generate, and Copy all or Download. Every line has its own session ID. 2. **Add the type to each line.** BitBrowser's Batch Add reads the type from the start of the line, followed by `://`. A line without a type is stored as Socks5, so HTTP lines on port 8080 need `http://` in front. A name for the proxy can go at the end in curly brackets. 3. **Store them in BitBrowser.** Open Proxy IP, then Proxy Management, open the Add menu and choose Batch Add. Paste one proxy per line, up to 100 at a time, click Batch Detection to see the detected IP of each line, then Confirm. 4. **Bind each proxy to a profile.** Use the Bound Profiles icon in the proxy list, or open a profile and pick the saved proxy with Method set to Proxy Management. For profiles that already exist, More, then Batch Proxy Settings, on the Browser Profiles screen changes the proxy of the selected profiles. ``` http://residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p01-ttl-60m:PASS{NL profile 01} http://residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p02-ttl-60m:PASS{NL profile 02} http://residentialpremium.quantumproxies.io:8080:USER-country-nl-sid-p03-ttl-60m:PASS{NL profile 03} ``` Batch Add with QuanticData lines: the type at the start, the profile name at the end. Redrawn screen with our values. To create the profiles and their proxies in one go, Batch Import on the Browser Profiles screen takes BitBrowser's Excel template: a proxy type column (http, https, socks5 or ssh) and the proxy as Host:Port:Username:Password, up to 1,000 rows per import. ## A new IP for a profile With QuanticData Residential Premium and Mobile the IP belongs to the session ID in the username, so a new session ID, for example `-sid-p02` instead of `-sid-p01`, gives a new IP: change it in Username, click Check Proxy and Confirm. The old line keeps working until its lifetime ends. ISP proxies are static addresses by design: one IP per profile, for months. In all three cases Refresh Proxy stays empty. ## BitBrowser proxy not working: errors and fixes A proxy that fails shows up in three places: Check Proxy in the profile returns no result, the Detected IP column of Proxy Management shows a dash instead of an address, or the profile does not open. BitBrowser's documentation lists three causes for a profile that fails to launch: the proxy connection, your local internet connection, or the fingerprint settings. These are the cases behind the first one, in the order to check. The most common failure after a Batch Add: a line without http:// becomes Socks5 on the HTTP port. Redrawn screen. | What you see | Usual cause | Fix | | --- | --- | --- | | Check Proxy gives no result, or Detected IP shows a dash | The type does not match the port: Socks5 on 8080 or HTTP on 1080, often a Batch Add line without `http://` | Edit the proxy: Type HTTP with 8080, Socks5 with 1080, then check again | | The same, with the right type | The username was cut, a colon is missing, or a space came with the paste | Copy the line again from the generator's Preview and paste it whole into Host | | The check worked yesterday, fails today | The plan expired or its traffic is used up | Check the plan in My proxies: status, remaining traffic, expiry date | | Wrong country or time zone | No `-country-` in the username, or Worldwide chosen in the generator | Generate the line with a country; let the profile take its time zone from the IP | | Right country, a different city than expected | Lookup services place the same IP differently; BitBrowser's documentation notes the gap between its channels | Check the country and the IP; switch Lookup Channel to compare | | The IP changes in the middle of a session | The session lifetime ended, or two profiles share one session ID | A longer `-ttl-` and a different `-sid-` in every profile | | Check Proxy works, pages do not load | Your local network, not the proxy: BitBrowser's documentation separates the two | Run the test below from the same computer; if it works, contact BitBrowser support | One test outside the browser settles most cases in a minute. If this returns an address in the right country, the proxy works and the problem is in the profile's fields: ``` curl -x http://residentialpremium.quantumproxies.io:8080 \ -U "USER-country-nl-sid-test-ttl-10m:PASS" https://ipinfo.io/json ``` If the same command fails on your network but works from another one, a firewall or your provider is blocking the connection to the proxy port. ## HTTP or Socks5 in BitBrowser Both work for browsing, and every QuanticData network offers both. HTTP on port 8080 is the simpler choice and the one to start with; it carries HTTPS sites too. Socks5 on port 1080 passes any kind of connection, not only web pages, which matters for tools inside the profile that do not speak HTTP; the details are on the page for [SOCKS5 proxies](https://quanticdata.io/socks5-proxies/). What breaks a profile is never the choice itself, only a type that does not match its port. For a wider view of why each profile needs its own address, see [residential proxies for antidetect browsers](https://quanticdata.io/residential-proxies/for/antidetect-browsers/). ## Before you run accounts A proxy changes where a profile's traffic comes from, not what the profile is allowed to do. Keep to each platform's terms and to the law where you work, and use one profile, one session and one identity per account. ### Sources & further reading - [BitBrowser documentation: add a new browser profile](https://doc.bitbrowser.net/help1/browser-profiles/add-a-new-browser-profile) - [BitBrowser documentation: Http/Https/Socks5/SSH proxy and batch import](https://doc.bitbrowser.net/help1/proxy/http-https-sock5-ssh) - [BitBrowser documentation: Proxy IP Management and Batch Add](https://doc.bitbrowser.net/help1/proxy/proxy-ip-management) - [BitBrowser documentation: how to fix the browser proxy failure](https://doc.bitbrowser.net/question/master-tutorial/how-to-fix-the-browser-proxy-failure) - [BitBrowser: automatic proxy IP matching (time zone and language from the IP)](https://www.bitbrowser.net/team-work/automatic-proxy-ip-matching) - [RFC 1928: SOCKS Protocol Version 5](https://www.rfc-editor.org/rfc/rfc1928) ## FAQ Quick answers on bitbrowser proxy setup. [Something else? Ask us](mailto:hello@quanticdata.io) ### How do I add a proxy to BitBrowser? Open Browser Profiles, click Add or open an existing profile, and go to the Proxy section. Keep Method on Custom, set Type to HTTP for port 8080 or Socks5 for port 1080, paste the proxy as host:port:user:pass into Host, click Check Proxy and then Confirm. To store proxies without a profile, use Proxy IP, Proxy Management, Add. ### What proxy format does BitBrowser accept? In a profile, a whole Host:Port:Username:Password line pasted into Host is split into the four fields. In Batch Add, each line can start with the type followed by ://, such as http:// or socks5://, and end with a name in curly brackets; a line without a type is stored as Socks5. The Excel template of Batch Import takes Host:Port:Username:Password with the type in its own column. ### Why does the proxy check fail in BitBrowser? Most often the type does not match the port: on QuanticData HTTP needs 8080 and Socks5 needs 1080, and a Batch Add line without http:// becomes Socks5. Next come a username cut or pasted with a space, and a plan that expired or ran out of traffic. Test the same values with curl outside the browser: if curl works, fix the profile's fields; if it fails, check the plan or your network. ### Can I add many proxies to BitBrowser at once? Yes. Under Proxy IP, Proxy Management, the Add menu has Batch Add: one proxy per line, up to 100 at a time, then Batch Detection and Confirm. Batch Import on the Browser Profiles screen creates profiles with their proxies from an Excel template, up to 1,000 rows per import. The QuanticData generator makes the sticky lines, each with its own session ID. ### Does BitBrowser work with mobile proxies? Yes. A mobile proxy goes in like any other: Type HTTP with port 8080 or Socks5 with 1080, the sticky line from the generator pasted into Host, one session per profile. Mobile plans also offer IP whitelist authentication, in which case Username and Password stay empty. Leave Refresh Proxy empty; a new session ID gives a new IP. ### Is BitBrowser free? BitBrowser's documentation says a new account gets 10 free browser profiles, and more profiles need a paid plan; the current plans are on BitBrowser's pricing page. The proxy is separate: BitBrowser stores and checks it, the IP comes from your proxy provider. ## One sticky IP for every BitBrowser profile Residential Premium, ISP and mobile proxies with country targeting and sticky sessions up to 1440 minutes, HTTP and SOCKS5, copied straight from the endpoint generator into BitBrowser. [Start free — $2/month included](https://quanticdata.io/signup/?utm_source=blog&utm_medium=website&utm_campaign=blog-end&utm_content=bitbrowser-proxy-setup)[Explore Residential Proxies from $0.80/GB](https://quanticdata.io/residential-proxies/) ## Related reading [Proxies GoLogin Proxy Setup: Add, Check and Fix Open the profile, go to Proxy, choose Your proxy, enter host, port, login and password with the type that matches the port, click Check Proxy and save. Below: the exact field names, the formats GoLogin accepts, one sticky session per profile, Residential Premium, ISP and mobile proxies, bulk import and a fix for each error. Read more](https://quanticdata.io/blog/gologin-proxy-setup/) [Proxies Incogniton Proxy Setup: Add, Check and Fix Open the profile's Proxy tab, choose Custom proxy, set Connection type to HTTPS for port 8080 or SOCKS5 for port 1080, paste host:port:username:password into Proxy (ip:port), click Check and save. Below: each step with the version 5 field names, one sticky session per profile, Residential Premium, ISP and mobile lines, the Proxy Library bulk import and a fix for every error. Read more](https://quanticdata.io/blog/incogniton-proxy-setup/) [Proxies MoreLogin Proxy Setup: Add, Check and Fix In Advanced create choose New proxy, set the type that matches the port, put host and port in Proxy server, the whole username in Proxy account, run proxy detection and confirm. Below: every field, one sticky session per profile, Batch add without the SOCKS5 trap, ISP and mobile proxies, cloud phones and a fix for each error. Read more](https://quanticdata.io/blog/morelogin-proxy-setup/) --- Source: https://quanticdata.io/blog/bitbrowser-proxy-setup/ · Site index for AI: https://quanticdata.io/llms.txt