> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clianta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxy Errors

> Troubleshoot proxy connection, speed, and geo-matching issues

Proxy issues are among the most common problems when setting up accounts. Here's how to diagnose and fix them.

<AccordionGroup>
  <Accordion title="Proxy test fails — connection refused or timeout">
    **Cause:** Clianta can't reach Instagram through your proxy.

    **Fixes:**

    * Double-check the proxy URL format: `protocol://user:pass@host:port`
    * Verify your proxy credentials are correct (username and password)
    * Make sure the proxy is active and not expired
    * Check if your proxy provider requires IP whitelisting — add your server's IP
    * Try switching the protocol (e.g., from `http://` to `socks5://`)
    * Contact your proxy provider to confirm the proxy is operational
  </Accordion>

  <Accordion title="Proxy is slow (over 3 seconds)">
    **Cause:** High latency between your server and the proxy.

    **Fixes:**

    * Choose a proxy geographically closer to your server
    * Check if the proxy provider is experiencing degraded performance
    * Consider upgrading to a higher-tier proxy plan
    * If the proxy is consistently slow, switch to a different provider

    <Note>
      Proxies over 3 seconds frequently cause timeouts during automation. Under 1 second is ideal.
    </Note>
  </Accordion>

  <Accordion title="Country not detected automatically">
    **Cause:** Clianta couldn't determine your proxy's location from its hostname or IP.

    **Fix:** Select the country manually in the **Proxy & Geo** tab. Choose the country that matches where your proxy is physically located.

    <Warning>
      Automation won't start until the proxy country is set. This ensures your account's timezone and geographic signals are consistent.
    </Warning>
  </Accordion>

  <Accordion title="Geo mismatch — timezone or location doesn't match">
    **Cause:** The signals detected during browser launch don't match the expected country.

    **Fixes:**

    * Verify you selected the correct country in proxy settings
    * Check that your proxy provider is actually routing through the country they claim
    * Run the proxy test again — it shows the detected country and IP
    * If the proxy uses a different exit country than advertised, contact your provider or switch proxies
  </Accordion>

  <Accordion title="Proxy works but Instagram shows wrong location">
    **Cause:** The proxy's IP is registered to a different country than expected.

    **Fix:** Run the proxy test in Clianta to see the actual detected country. Update your country setting to match the detected location, or switch to a proxy that exits from your desired country.
  </Accordion>

  <Accordion title="Proxy stopped working after it was fine before">
    **Causes:**

    * Proxy subscription may have expired
    * Proxy provider may have rotated or retired the IP
    * Your IP may have been blocked by your provider due to policy violations

    **Fix:** Test the proxy again. If it fails, check your proxy provider's dashboard for status updates, then replace the proxy if needed.
  </Accordion>
</AccordionGroup>

## Recommended proxy setup

| Guideline                                   | Why                                                                |
| ------------------------------------------- | ------------------------------------------------------------------ |
| Use **one proxy per account**               | Sharing proxies between accounts is a major ban risk               |
| Choose **static residential** proxies       | Most trusted by Instagram                                          |
| Pick a location matching your target market | Looks natural to Instagram                                         |
| Test before first login                     | Ensures everything works before you establish the account's "home" |

<CardGroup cols={2}>
  <Card title="Proxy Setup Guide" icon="shield-halved" href="/connecting/proxy-setup">
    Full proxy setup instructions
  </Card>

  <Card title="Common Issues" icon="circle-question" href="/troubleshooting/common-issues">
    Other troubleshooting topics
  </Card>
</CardGroup>