Octo Browser
Octo Browser Proxy Setup Guide
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
- The first thing you will need to do to get started is to download the application and create an account with Octo Browser, which you can do here.
- Open the Octo Browser application.
- In the Profiles section, press the Create Profile to enter the setup page.

Octo Browser - Create profile
- First, in the Basic tab, enter a profile name, and then add any other details you might need.

Octo Browser - Profile setup
- Go to the Connection tab and click on the Proxy field. Click on the + Set a new proxy button.

Octo Browser - Adding a proxy
- In the Set a new proxy pop-up window, select the proxy type and input the proxy details, which can be found on your Decodo dashboard. Here's an example for residential proxies:
- Host:
gate.decodo.com - Port:
10001 - Login: Input your
proxy username - Password: Input your
proxy password - You can also save this configuration by ticking off the Save to the Proxy Manager checkbox; in this case, in the Proxy title field, you will need to name the particular proxy.
- Host:

Octo Browser - Set a new proxy window
- You can click on Check proxy button to see if the proxy is available to ensure that the setup is functional. Once done click Confirm to assign the proxy to the Browser profile.

Octo Browser - Checking IP availability
- Finally, click on the Create Profile button.

Octo Browser - Creating a profile
Add Proxies in Bulk or Separately
You can create and link proxy and browser profiles in Octo Browser separately and in any order you find convenient. E.g., you can add proxies in the Proxies section by clicking on the Add Proxy or Bulk Addbuttons and then later assign them to specific profiles.

Octo Browser - Adding proxies
Launch a Profile
Once you have created a profile and linked a proxy to it you can launch it from the Profiles section by clicking Start.

Octo Browser - Launching a browser profile
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
SOCKS5
Residential and Mobile Proxy Support
SOCKS5for 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-uswill 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-30will 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:PORTformat 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].
Updated 11 days ago