How To Set Up Charles Proxy on macOS

Originally published at Analyst Admin.

This guide is for anyone who needs to inspect and/or modify HTTP requests to and from your macOS or Mac OS computer. For example, if you need to inspect Adobe Analytics or Google Analytics tracking beacons from Safari or Chrome.

See here for the Charles for Windows PC Guide.

macOS Charles proxy use cases:

  • QA/verify Adobe Analytics or Google Analytics tracking beacons
  • Inspect and/or transform HTTP requests to and from your PC
  • Throttle connection either to specific hosts or all hosts
  • Local proxy for websites, apps, iOS Simulator, or Android Studio
  • Set up macOS to proxy for iOS, iPhone, iPad, Android, tvOS, and Apple TV
  • Monitor tracking beacons from Safari, Chrome, Firefox, Edge
  • Proxy HTTP & HTTPS traffic for macOS Mojave and macOS Catalina

Charles Proxy is a powerful website optimization and QA tool for developers, analysts, and engineers. With Charles, you can monitor exactly how your application communicates with a remote server.

Parts covered in post:

Part 1 —Charles Certificate Set Up

Part 2 — Charles SSL Proxying Set Up

Part 3 — iOS Simulator Charles Proxy Set-Up

Part 4 — Common Issues with Charles Proxy

Part 1 — Charles Certificate Set Up

The first part of the guide will help you add the Charles SSL Certificate to your Mac so that Charles can decrypt any local HTTPS traffic.

Step 0 — Download and install Charles

Step 1 — Open Charles then go to Help > SSL Proxying > Install Charles Root Certificate

Step 2 — The Keychain Access window will open up. Notice “Charles Proxy CA” shows up with an “X”.

Step 3 — Double click on “ Charles Proxy CA “.

Step 4 — A new window showing the details of the Charles Proxy CA certificate will open up.

Step 5 — Expand Trust, then click into the “ When using this certificate” dropdown and select “ Always Trust “.

-> Continue reading the full guide at Analyst Admin.

Originally published at on November 7, 2020.

Hi! I’m an analyst and administrator who enjoys helping the analytics community.