Home

Charles Docs-y

The Unofficial docs for Charles Proxy

Configure Charles Root certificate on Mac

The Root certificate is the magic ingredient that allows Charles to decrypt HTTPS traffic. This certificate basically tells your MacBook to give Charles permission to view and modify all HTTPS traffic that flows in and out of your machine. This becomes incredibly useful when testing your application and you need to modify HTTPS traffic. This…

iOS devices and Charles

This setup guide will help you configure Charles and your device so you can view your app’s network traffic in plain text. NOTE: You can’t view/intercept the traffic of apps with a pinned certificate. Most apps with sensitive data, e.g. banking apps, will block you from viewing/intercepting their traffic. If you just want to play…

Android devices and Charles

This tutorial will show you how to configure Charles and your device so you can view your app’s network traffic in plain text. NOTE: Since Android Nougat (7.1), Google have blocked you from intercepting/decrypting network traffic from Play Store apps. NOTE: To proceed with this tutorial, you will need to be able to build your…

Breakpoints – Modify the Request

The Breakpoint feature is great if you want to just intercept 1 Request (or Response) and modify some element of it. If you are a frequent user of Breakpoints, you also should have a look at the Rewrite feature. The following tutorial will show you how to use the Breakpoints feature to intercept a Request,…

Rewrite – Modify the Request and the Response

The Rewrite feature allows you to automatically change parts of HTTP Requests and Responses every time they meet a pre-defined set of rules. This tutorial will show you how to use the Rewrite feature to change the Request and the Response. Please note that you need to complete the Rewrite – Modify the Request tutorial…

Rewrite – Tips & Tricks

Here are some tips and tricks I’ve picked up over the years while working with Rewrites that make creating them a little easier! The ‘Notes’ Columns Swap ‘Info’ column for ‘Notes’ The more Rewrites you use the more sense it makes to swap the ‘Info’ column for the ‘Notes’ one Right-click the the bar with…

Android Articles

Common Problems – Android

08 Jul 2020, updated: 16 Mar 2022 Here are some of the common issues people face when working with Android and Charles. Details on how…

Keep reading

Android Emulators and Charles

30 Jun 2021, updated: 21 Oct 2021 The only slight difference between configuring Charles to work for physical devices and emulators, is the wifi network.…

Keep reading

iOS Articles

iOS devices and Charles

This setup guide will help you configure Charles and your device so you can view your app’s network traffic in plain text. NOTE: You can’t…

Keep reading

Common Problems – iOS

Last updated: 22 Nov 2022 Here are some of the common issues people face when working with iOS and Charles. Details on how to fix…

Keep reading

Rewrite Articles

Rewrite – Modify the Response

The Rewrite feature allows you to automatically modify distinct parts of the Response. Here are some helpful use cases: The Rewrite feature has a long…

Keep reading

Rewrite – Redirect URL

Rewriting URLs can be really useful if you need to point your new build to a specific environment i.e. point Prod build at non-Prod env.…

Keep reading

Rewrite – Modify the Request

The Rewrite feature allows you to automatically modify different elements of a Request. If you are familiar with Breakpoints, you can think of Rewrites as…

Keep reading

Latest

Expired Charles Proxy Root Certificate

Originally published 29 Dec 2021, updated: 29 Sept 2023 To comply with Apple’s rules regarding MacOS certificate expiry dates, Charles’ root certificates have much shorter…

Keep reading

Advanced Repeat

09 Nov 2020, updated: 04 Jan 2021 The Advanced Repeat feature lets you automatically hit endpoints at predefined intervals. You can also to add delays…

Keep reading

Loading…

Something went wrong. Please refresh the page and/or try again.

Get new content delivered directly to your inbox.