BitBrowser

Getting Started

Before proceeding, ensure you have:

No other VPN or proxy active.
The proxy endpoint and port (e.g., us.decodo.com:10101).
Your proxy username and password (or a whitelisted IP set).

📘
Proxy Guides

Learn how to find proxy details in your dashboard for each proxy type here.

Proxy Setup

First, create an account here.
Then download BitBrowser on your device.
Open up the BitBrowser app and log into your BitBrowser account.

Navigate to the Browser Profiles tab and click "Add" to add a new profile/proxy:

A settings tab should appear on the right side; scroll down until you find Proxy and select the appropriate proxy type:

You can view all the special settings you can select for this browser here.

Input the proxy details/endpoint into the correct fields, and choose the Proxy Type (HTTP, HTTPS, or SOCKS5). Next, the proxy details can be found on your Decodo dashboard. Here's an example for residential proxies:
- Host: gate.decodo.com
- Port: 7000
- Username: Input yourproxy username
- Password: Input your proxy password
- You can go into advanced options and customize your browser fingerprint if needed.
Once input, you can double-check if the proxy works by clicking "Check proxy":
Click "Confirm" in the bottom right corner. The profile should be saved, and that's it.

Verify the Connection

Visit ip.decodo.com. If successful, your IP address will display the location of the proxy.

Common Issues

Blocklist

⚠️
Target Access

Please be aware that we restrict access to some domains. You can learn more here.

`SOCKS5`

🚧
Residential and Mobile Proxy Support

SOCKS5 for residential and mobile proxies requires specific settings to target the correct locations and prevent proxy rotation:

Country Endpoint Support

Please note that you must use the gate.decodo.com endpoint and the 7000 port to utilize SOCKS5 Residential or Mobile proxies. Country endpoints, such as us.decodo.com, will not function!

You can target specific locations instead by specifying the location in your username using advanced parameters:

e.g.: user-username-country-us will connect to the USA pool.

Proxy Rotation

To get a sticky SOCKS5 Residential or Mobile proxy in a tool, you must use a session parameter. Otherwise, the proxy will always rotate even with a set sessionduration parameter.

e.g.: user-username-session-abc123-sessionduration-30 will connect to the same session.
The session ID name can be defined by any string of your choice.

Learn more in our advanced parameter guides for Residential and Mobile proxies.

Direct IP

Direct IP Parameter Support

If you buy an IP list, you can specify which IPs to connect to using the direct ip parameter in the proxy username: user-username-ip-x.x.x.x

Supported products: DC Pay/IP, Dedicated DC, ISP Pay/IP, Dedicated ISP plans.
Products that offer access to the full proxy pool, such as residential proxies, do not support this parameter.

IP:PORT

Decodo proxies don't support an IP:PORT format by default;
You must use the endpoint rotator format (e.g., us.decodo.com:10101).
If necessary, try the workaround here, but it only works temporarily before requiring another setup update.

Troubleshooting

If you experience any other issues, please refer to our main troubleshooting section.

Support

Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].

Feedback

Something's missing? Request an article!
Got feedback? Let us know how we're doing and what can be improved.