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

# iOS

> How to setup Geonode proxy in iOS device using built-in Wi-Fi settings

***

This guide will help you configure a **Geonode Proxy** on your iPhone using  Wi-Fi connections.

***

## Prerequisites: Get Proxy Credentials from Geonode

Before setting up a proxy, first, retrieve your proxy credentials from the Geonode dashboard.

* Follow this guide: [How to Obtain Proxy Server Information](/proxy-setup/prerequisites/proxy-server-information)

***

## **Steps: Setting Up a Proxy in iOS**

Follow these steps to configure a proxy in iOS:

### **Step 1: Open iPhone Settings**

1. Open the **Settings** app on your iPhone.
2. Tap on **Wi-Fi** to view available networks.

   <img src="https://mintcdn.com/geonode/2jt786SDLn4O6sN3/images/proxy-setup/mobile-os/ios/mobile-setting.png?fit=max&auto=format&n=2jt786SDLn4O6sN3&q=85&s=0bd88c51adb866d73355cf58fc30df6e" alt="Open Mobile Settings" width="372" height="341" data-path="images/proxy-setup/mobile-os/ios/mobile-setting.png" />

***

### **Step 2: Access Wi-Fi Network Settings**

1. Connect to the Wi-Fi network you want to configure a proxy for.
2. Tap the **"i" icon** next to the connected network.

   <img src="https://mintcdn.com/geonode/mqpxmUyuPWS52Yyg/images/proxy-setup/mobile-os/ios/i-icon.png?fit=max&auto=format&n=mqpxmUyuPWS52Yyg&q=85&s=4313a06ff35fa7b04b5d207a6d404d1d" alt="i icon" width="373" height="325" data-path="images/proxy-setup/mobile-os/ios/i-icon.png" />

***

### **Step 3: Navigate to Proxy Settings**

1. Scroll down to the **"HTTP Proxy"** section.\\
   <img src="https://mintcdn.com/geonode/2jt786SDLn4O6sN3/images/proxy-setup/mobile-os/ios/proxy-config.png?fit=max&auto=format&n=2jt786SDLn4O6sN3&q=85&s=5d6486b9818434b74c3d9c2f2e8586b2" alt="Proxy Configuration" width="372" height="221" data-path="images/proxy-setup/mobile-os/ios/proxy-config.png" />
2. You will see three options:

   * **Off** (No proxy configured)
   * **Manual** (Enter proxy details manually)
   * **Automatic** (Uses a PAC file for configuration)

   Select **Manual** for Geonode proxy setup.

   <img src="https://mintcdn.com/geonode/2jt786SDLn4O6sN3/images/proxy-setup/mobile-os/ios/select-manual.png?fit=max&auto=format&n=2jt786SDLn4O6sN3&q=85&s=d803646bcf866161ca6c09b65c1ba755" alt="Proxy Manual Configuration" width="380" height="218" data-path="images/proxy-setup/mobile-os/ios/select-manual.png" />

***

### **Step 4: Enter Proxy Details**

1. Under **Manual Proxy Configuration**, enter:
   * **Server (Proxy IP Address)**
   * **Port**

2. If authentication is required, toggle **Authentication ON** and enter your **username** and **password**.

   <img src="https://mintcdn.com/geonode/2jt786SDLn4O6sN3/images/proxy-setup/mobile-os/ios/server-details.png?fit=max&auto=format&n=2jt786SDLn4O6sN3&q=85&s=382fd758fa9eb5c7a2e6abe1bb009f09" alt="Enter Proxy Details" width="380" height="312" data-path="images/proxy-setup/mobile-os/ios/server-details.png" />

3. Tap **Save** to apply changes.

<Note>
  Note: Once the Proxy server is set up, a prompt for example on google chrome or other applications or programs on the system may request to provide proxy authentication which is the proxy username and password. This is required to proceed using the proxies. If you do not wish to provide authentication, you can consider to whitelist your IP. Refer to this guide for [How to Whitelist an IP](/proxy-setup/advance-configuration/whitelist-ip)
</Note>

***

## **Verify Proxy Connection**

To ensure the proxy is working, check your IP address using an online tool or follow this guide:

* [Verify Proxy Connection](/proxy-setup/verify-proxy-connection)

***

If you encounter any issues, refer to the [**troubleshooting section**](/knowledge-base/troubleshooting/proxy-not-working) or [**Geonode support**](/additional-resources/support).

***

## **FAQs**

<AccordionGroup>
  <Accordion title="My proxy connection failed. What should I do?" defaultOpen={false}>
    If your connection fails, check the following:

    * Ensure that your proxy credentials (IP, Port, Username, Password) are correct.
    * Verify that your proxy is active in the Geonode Dashboard.
    * Try another proxy format if the selected one isn't working.
    * Refer to this guide for troubleshooting: [Troubleshooting Proxy Connection Issues](/knowledge-base/troubleshooting/pages-not-loading)
  </Accordion>

  <Accordion title="Why is my IP address not changing?" defaultOpen={false}>
    * You may be using a Sticky Session proxy that keeps the same IP for a certain duration.
    * If using a Rotating Session, verify that your requests are being routed through the proxy correctly.
    * Check your connection using an IP verification tool: [Verify Proxy Connection](https://ip-api.com/)
  </Accordion>

  <Accordion title="Why am I getting a CAPTCHA while browsing?" defaultOpen={false}>
    * Some websites detect **frequent IP changes** and show CAPTCHAs as a security measure.
    * Use Sticky Sessions if you need a stable connection.
    * Try switching to a mobile or residential proxy for lower detection rates.
  </Accordion>

  <Accordion title="My proxy is working, but the internet is slow. What should I do?" defaultOpen={false}>
    * High latency can occur if the proxy server is far from your location.
    * Try using a different proxy region to improve speed.
    * Reduce the number of simultaneous requests to avoid overloading the proxy.
  </Accordion>

  <Accordion title="Why am I getting the authentication prompt repeatedly?" defaultOpen={false}>
    * This can happen if the proxy authentication credentials are not correctly stored or passed by your browser or application. Ensure that the correct username and password are saved in your proxy settings.
    * Or you can whitelist your IP. Refer to this guide for [How to Whitelist an IP](/proxy-setup/advance-configuration/whitelist-ip)
  </Accordion>
</AccordionGroup>
