> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/getting-started/setting-up-your-proxidize-proxies/setting-up-your-proxidize-proxies-on-ios.md).
# Setting up your Proxidize Proxies on IOS
This guide shows you how to set up your Proxidize proxy on an iPhone or iPad.
On iOS, proxies are configured **directly inside your Wi-Fi network settings**. This is because Proxidize proxies are secured to allow web traffic only, connections are permitted over **port 80 (HTTP)** and **port 443 (HTTPS)**, and other ports are blocked. Due to these port restrictions, configuring the proxy on the Wi-Fi network is currently the reliable way to use Proxidize proxies on iOS.
{% hint style="warning" %}
**Read This First**
**What to Expect** After you apply the proxy, your iPhone may show a **"No Internet Connection"** warning, or the Wi-Fi icon may look inactive. **This is normal and expected.** It happens because iOS checks connectivity using ports that the proxy blocks. Your proxy is still working, you use it by **opening a web browser** (Safari or Chrome) and browsing normally.
{% endhint %}
By the end of this guide, your device will route web browsing through your Proxidize proxy over your Wi-Fi network.
***
### Prerequisites
Before you start, make sure you have the following ready:
* [ ] Your Proxidize **HTTP** Proxy Credentials
* [ ] **An iPhone or iPad** connected to a **Wi-Fi network**
{% hint style="info" %}
**💡 Where do I find my proxy details?** Your host, port, username, and password are shown in your Proxidize dashboard. Keep them nearby before you begin. See [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies.md) for more detials.
{% endhint %}
***
{% stepper %}
{% step %}
### Open Wi-Fi Settings and Select Your Network
First, make sure you are connected to the Wi-Fi network you want to use.
1. Open the **Settings** app on your iPhone or iPad.
2. Tap **Wi-Fi**.
3. Connect to your Wi-Fi network if you are not already connected.
{% hint style="warning" %}
**⚠️ Wi-Fi Only**
This method applies the proxy to **Wi-Fi only**. It does not apply to cellular (mobile) data. You must be on Wi-Fi to use the proxy.
{% endhint %}
{% endstep %}
{% step %}
### Open the Network Configuration
Now open the detailed settings for your connected network.
1. Next to your connected Wi-Fi network name, tap the **ⓘ (info) icon**.
2. Scroll to the bottom of the page until you see the **HTTP Proxy** section.
{% endstep %}
{% step %}
### Configure the HTTP Proxy
This is where you enter your Proxidize proxy details.
1. In the **HTTP Proxy** section, tap **Configure Proxy**.
2. Select **Manual**.
3. Enter your proxy details:
* **Server:** your proxy host or IP (e.g. `pg.proxi.es`)
* **Port:** your HTTP proxy port (e.g. `20000`)
4. Turn **Authentication** **ON**.
5. Enter your **Username** and **Password**.
6. Tap **Save** in the top-right corner.
{% hint style="warning" %}
**Critical Step**
Make sure **Authentication** is turned ON and your username and password are entered correctly. Without them, the proxy will reject the connection.
{% endhint %}
{% endstep %}
{% step %}
### Verifying Your Connection
Your proxy is now active on this Wi-Fi network.
{% hint style="info" %}
**Ignore the "No Internet" Warning** At this point your iPhone may show **"No Internet Connection"** or a similar message. **Do not worry, this is expected.** The proxy only allows web traffic, so system checks fail, but browsing works.
{% endhint %}
To confirm the proxy is working:
1. Open a web browser (**Safari** or **Chrome**).
2. Visit one of these sites:
* `https://whoer.net`
* `https://whatismyip.com`
3. Check the IP address shown on the page.
If the IP address matches your Proxidize proxy location, your setup is working correctly.
{% hint style="info" %}
**💡 Remember**
Web browsing through a browser is how you use the proxy on iOS. Other apps that rely on non-web ports may not work while the proxy is active.
{% endhint %}
{% endstep %}
{% endstepper %}
***
### Tips & Troubleshooting
#### How to turn the proxy off
When you want to stop using the proxy:
1. Go to **Settings → Wi-Fi**.
2. Tap the **ⓘ (info) icon** next to your network.
3. Tap **Configure Proxy** and select **Off**.
4. Tap **Save**.
Your normal internet connection will return immediately.
#### Quick troubleshooting checklist
If your connection is not working, check these in order:
1. **Are you on the right Wi-Fi network?** The proxy applies only to the specific network you configured. Other Wi-Fi networks and cellular data are not affected.
2. **Is Authentication ON?** Confirm the toggle is enabled and your username and password are correct. They are case-sensitive.
3. **Is the port your HTTP port?** The iOS Wi-Fi proxy uses HTTP only, do not enter a SOCKS port.
4. **Test in a browser.** Remember that browsing in Safari or Chrome is the correct way to confirm the proxy, ignore the "No Internet" system warning.
***
### Need Help?
If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at .
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.proxidize.com/getting-started/setting-up-your-proxidize-proxies/setting-up-your-proxidize-proxies-on-ios.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.