Before you start
Use an activated connection and its assigned hostname, port, protocol, full username and proxy password. The proxy login is separate from the account used to sign in to the tool.
Use an officially supported FoxyProxy release for your browser. HTTP/HTTPS proxy authentication works in Chrome and Firefox; SOCKS5 username/password authentication is Firefox-only. The instructions below use an authenticated HTTP endpoint.
What is FoxyProxy?
FoxyProxy is a proxy-manager extension for Chrome, Firefox and supported Chromium browsers. The extension manages your chosen proxy service; installing it does not supply proxy access.
- One-click switching
- Select a saved proxy entry from the browser toolbar.
- Several saved connections
- Give each endpoint a clear title so you can choose the intended route.
- URL patterns
- Use the pattern features available in your edition to route matching sites.
- Free extension
- The extension is free to install. Proxy-service access is separate.
1. Open FoxyProxy options
Install FoxyProxy through the project’s official browser-store links. Open the extension menu and choose Options.
Enable the permissions required by your browser. Firefox requires the appropriate private-window permission for proxy settings; Chrome incognito access is enabled separately if you intend to use it.
2. Add your assigned connection
Open Proxies and choose Add. Set a title such as Crawlhub Residential and select HTTP for an HTTP proxy endpoint. Select HTTPS only when the connection to the proxy itself uses TLS.
Enter Hostname, Port, Username and Password from your assigned connection. Enter raw credentials in separate fields. On Chromium, use HTTP/HTTPS for password-authenticated proxies rather than SOCKS5.
| Connection field | What to use |
|---|---|
| Hostname | Assigned proxy hostname or IP, without a URL path |
| Port | Assigned port for this endpoint and protocol |
| Username | Full assigned username, including any configured targeting/session values |
| Password | Proxy password, not the browser-tool account password |
3. Save and choose the routing mode
Click Save. Add another entry for each connection you want to switch to.
Country, City and Color labels help identify an entry; they do not configure upstream geolocation. Use the location/session values supplied by your service. Pattern-based routing must include the intended sites and can be affected by exclusions or more specific proxy modes.
4. Turn it on and check the exit IP
Choose the saved Crawlhub entry from the FoxyProxy menu. Use its IP shortcut when available, or open an IP-check page in the same browser.
Confirm the address and location. Switching entries does not guarantee a new IP if both entries use the same upstream session or assignment. Use Disable when you want the extension to stop selecting that proxy.
Troubleshooting
SOCKS5 login fails in Chrome
Chromium does not support SOCKS5 proxy password authentication. Use an assigned HTTP/HTTPS endpoint, or verify Firefox support for your setup.
Some pages take a different route
Review global exclusions, pattern rules, private-window settings and any other extension or enterprise policy controlling proxies.
Location label and exit differ
The extension’s country/city labels are descriptive. Check the actual upstream targeting and observed exit IP.
