How To Setup Charles Proxy For Ios

To setup Charles Proxy for iOS, you need to run Charles on your Mac or Windows computer, connect your iPhone or iPad to the same Wi-Fi network, point the iOS device’s Wi-Fi proxy settings to your computer, then install and trust the Charles Root Certificate so HTTPS traffic can be inspected. Once that is done, you can capture app and browser requests from the iPhone or iPad in Charles.

What Charles Proxy does on iOS

Charles Proxy is a web debugging proxy that sits between your iPhone or iPad and the internet. It lets you inspect HTTP and HTTPS requests, see request and response headers, check payloads, and troubleshoot network behavior in apps or Safari.

For iOS, the setup has two parts:

HTTP proxying, which sends device traffic through Charles.
HTTPS interception, which requires installing and trusting the Charles Root Certificate on the device.

If you skip the certificate step, you may still see some traffic, but HTTPS content will usually not be readable.

What you need before you start

Before you begin, make sure you have the following:

Charles installed and running on a Mac or Windows computer
An iPhone or iPad on the same Wi-Fi network as the computer
Access to the Charles proxy host IP address
The Charles proxy port, which is commonly 8888 unless you changed it
Permission to inspect the device traffic you are capturing

Important: Only capture traffic on devices you own or are authorized to test. Proxy tools can expose sensitive data if they are used carelessly.

Find your computer IP and Charles port

iOS needs to know where Charles is running. That means you need your computer’s local IP address and the port Charles is listening on.

Open Charles on your computer.
Check the proxy port in Charles. The default is often 8888.
Find your computer’s local IP address on the same Wi-Fi network.
Use the local network address, not a public IP address.

If you are unsure of the IP address, look in your computer’s Wi-Fi or network settings. On macOS, it is usually shown under Wi-Fi details. On Windows, you can check the active network adapter details.

Example: If your computer IP is 192.168.1.25 and Charles is using port 8888, that is the host and port you will enter on the iPhone or iPad.

Set the iPhone or iPad HTTP proxy

Now configure the iOS device to send Wi-Fi traffic through Charles.

Open Settings on the iPhone or iPad.
Tap Wi-Fi.
Tap the i icon next to the Wi-Fi network you are using.
Scroll to HTTP Proxy.
Select Manual.
Enter your computer’s local Server IP address.
Enter the Port used by Charles, commonly 8888.
Leave authentication off unless your Charles setup specifically requires it.

After this step, the device will route Wi-Fi traffic through Charles whenever it stays connected to that network.

Install and trust the Charles certificate

To inspect HTTPS traffic, iOS must trust the Charles Root Certificate. Without this, encrypted requests will not be decrypted for viewing.

Keep Charles running on your computer.
On the iPhone or iPad, open Safari.
Go to the Charles certificate installation page provided by Charles.
Download and install the certificate profile when prompted.
Open Settings.
Tap General, then VPN & Device Management or Profiles, depending on your iOS version.
Find the Charles profile and install it if needed.
Go to Settings again.
Tap General, then About.
Scroll to Certificate Trust Settings.
Enable full trust for the Charles certificate.

Once trust is enabled, iOS will allow Charles to decrypt HTTPS traffic for the apps and sites you test.

Enable SSL proxying in Charles

Installing the certificate on iOS is not enough by itself. Charles also needs SSL proxying enabled for the domains you want to inspect.

Open Charles on your computer.
Go to Proxy and enable SSL Proxying if it is not already enabled.
Open Proxy Settings or SSL Proxying Settings.
Add the hostnames you want to inspect.
If you want to test broadly, you can often add a wildcard rule for development or debugging, depending on your setup and Charles version.

This step matters because Charles only decrypts HTTPS for hosts you have allowed. HTTP traffic may already appear in plain text, but HTTPS usually needs explicit SSL proxying.

Test that traffic is being captured

After the proxy and certificate are configured, verify the setup before troubleshooting anything complex.

Keep the iPhone or iPad connected to the same Wi-Fi network.
Make sure Charles is still running on the computer.
Open Safari or a networked app on the iOS device.
Refresh a page or trigger a request.
Look in Charles for new requests.

A quick verification checklist:

The device is on the same Wi-Fi network as the computer
The proxy IP address is correct
The proxy port matches Charles
The Charles certificate is installed and trusted on iOS
SSL proxying is enabled for the target host

If all of those are correct, you should see traffic appear in Charles almost immediately.

Fix common Charles Proxy setup problems

If Charles is not capturing traffic on iOS, the issue is usually one of a few common mistakes.

No traffic appears in Charles

Check that Charles is open and running on the computer.
Confirm the iPhone or iPad is on the same Wi-Fi network as the computer.
Verify the server IP address in iOS matches the computer’s local IP.
Confirm the port is correct, usually 8888.
Make sure the Wi-Fi proxy setting is set to Manual, not Off.

Traffic appears, but HTTPS content is not readable

Confirm the Charles certificate is installed on the device.
Check that the certificate is trusted in Certificate Trust Settings.
Make sure SSL proxying is enabled in Charles for the relevant hostnames.

The device says it cannot connect to the internet

The proxy IP or port may be wrong.
Your computer may be asleep or disconnected from Wi-Fi.
A firewall may be blocking Charles from accepting connections.
Charles may not be listening on the expected port.

Only some apps work

Some apps use certificate pinning and may block interception.
Some traffic may not use standard HTTP or HTTPS.
Some hostnames may not be added to SSL proxying settings.

If an app uses certificate pinning, Charles alone may not be enough to inspect its encrypted traffic.

Best practices for reliable iOS proxy testing

Use a stable Wi-Fi network while testing.
Keep the computer awake so Charles does not stop running.
Recheck the IP address if you switch networks.
Remove the proxy setting when you are finished testing.
Delete the certificate profile if you no longer need it on the device.

These simple habits prevent the most common setup and privacy issues.

Frequently Asked Questions About how to setup charles proxy for ios

How do I set up Charles Proxy on iPhone?

Open Wi-Fi settings on the iPhone, choose your network, set HTTP Proxy to Manual, then enter your computer’s local IP address and Charles port. After that, install and trust the Charles certificate for HTTPS traffic.

Why is Charles Proxy not capturing traffic on iOS?

The most common causes are a wrong IP address, an incorrect port, the device being on a different Wi-Fi network, Charles not running, or the certificate not being trusted.

How do I install the Charles certificate on iOS?

Open Safari on the iPhone or iPad, download the Charles certificate profile, install it in Settings, then enable trust under Certificate Trust Settings.

How do I trust the Charles Proxy certificate on iPhone?

After installing the certificate profile, go to Settings, then General, then About, then Certificate Trust Settings, and turn on full trust for the Charles certificate.

What port does Charles Proxy use?

Charles commonly uses port 8888, but you should confirm the port in Charles settings in case it was changed.

Can I use Charles Proxy on cellular data instead of Wi-Fi?

Charles is typically configured through the device’s Wi-Fi proxy settings, so the standard setup is for Wi-Fi networks rather than cellular data.

Do I need SSL proxying for every website?

You need SSL proxying for the HTTPS hosts you want Charles to decrypt. Plain HTTP traffic is easier to inspect, but modern sites usually use HTTPS.

Conclusion

To setup Charles Proxy for iOS, connect the device to the same Wi-Fi network as your computer, point the iPhone or iPad proxy settings to Charles, install and trust the Charles certificate, and enable SSL proxying for the hosts you want to inspect. Once the setup is correct, Charles becomes a practical tool for viewing and troubleshooting iOS network traffic, especially during app and web debugging.