We are currently updating our documentation. Content may change during this period - we kindly ask for your patience.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Proxy shows a connection error

If a profile gives a connection error, or shows a red cross and fails to launch, the cause is almost always one of a few common configuration issues. Follow these solutions in order before assuming the proxy itself is broken.

1. Check the basics first

Most connection errors come down to a mismatch between what your proxy expects and what's configured in Incogniton.

Check
What to confirm

Connection type

Confirm the connection type set on the proxy matches what your provider issued, HTTPS or SOCKS5.

IPv6 compatibility

If your proxy is an IPv6 proxy, it only works on websites that support IPv6. Confirm with your provider whether your proxy is IPv4 or IPv6.

Authentication method

Some proxies authenticate by username and password, others by IP authorization. Confirm which method your provider uses and that it matches your setup in Incogniton.

Port included

Make sure the port is included in the proxy address field, in the format ip:port.

2. Test the proxy outside Incogniton

If you've confirmed all of the above and the proxy still doesn't connect, the next step is testing the proxy independently of Incogniton.

See Test a proxy with an external tool for the full walkthrough using Firefox and FoxyProxy.

3. Manually configure Timezone, WebRTC, and Geolocation

If the proxy connects fine in a regular browser but still fails in Incogniton, the proxy itself is working. The issue is that Incogniton's server is unable to fetch IP-dependent data from that proxy to auto-configure your profile.

When this happens, set the Timezone, WebRTC, and Geolocation values manually instead of relying on auto-detection.

1

Set the timezone manually

Open the profile editor and go to Browser & Navigator. Turn off Fill timezone based on IP, then set the timezone manually. It's best to match this to the proxy's location.

2

Set the WebRTC IP manually

Go to Privacy & Network. Turn off Fill WebRTC Public IP based on the IP, then enter the proxy's public IP manually, or set WebRTC mode to Disabled if you'd rather not expose any IP through WebRTC.

3

Set the geolocation manually

In the same Privacy & Network tab, turn off Fill location based on IP, then enter coordinates manually. It's best to match these to the proxy's location, or set geolocation mode to Block if you'd rather not share coordinates at all.

If after you've worked through all of these steps, the proxy still won't connect, this points to a deeper issue with your proxy. Kindly reach out to your proxy provider.

Last updated

Was this helpful?