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

  1. 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.
  2. Open the Octo Browser application.
  3. In the Profiles section, press the Create Profile to enter the setup page.

Octo Browser - Create profile


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

Octo Browser - Profile setup


  1. Go to the Connection tab and click on the Proxy field. Click on the + Set a new proxy button.

Octo Browser - Adding a proxy


  1. 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 yourproxy 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.

Octo Browser - Set a new proxy window


  1. 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


  1. 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

🚧

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.

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.