🚀 Requestly is now SOC 2 Compliant! Ensuring top-notch security and privacy for your data.

Product
HTTP interceptor

Intercept & modify network requests, headers, API requests, and inject scripts.

API Client

A lightweight API Client to test APIs faster and share with teams.

Mock server

Create cloud based API Mocks to use in your web/mobile applications.

SessionBook

An all-in-one tool to capture, report, and debug errors with session replay.

GraphQL Support

Support for GraphQL APIs, better targeting with OperationName.

Solutions
Frontend Web/Mobile Developers

Requestly improves front-end workflows with local JS testing, mocking, and SessionBook debugging.

For QA engineers

QA engineers love Requestly for its features and ease of use, allowing easy edge case testing.

Support Engineer

Support engineers value Requestly for debugging, demoing, and overriding GTM and Adobe scripts.

Backend Developers

Requestly helps in improving back-end development workflows, by enabling testing.

Pricing
Resources
Pricing
Blog
Case Studies
Status
Github
Release Note
Student Programme
Docs
Download
Insights
Product Updates
Use Cases
Announcements
Case Studies

How to setup Charles proxy

Dinesh Thakur
February 18, 2025
2MIN READ
Learn how to quickly set up Charles Proxy for inspecting and debugging HTTP/S traffic. Step-by-step guide with SSL proxying instructions.

Introduction

Charles Proxy is a popular web debugging tool that helps developers and testers view all HTTP/S traffic between their machine and the internet. It’s widely used for troubleshooting, API testing, and monitoring network calls in real-time. In this guide, we’ll walk you through setting up Charles Proxy from scratch, so you can start intercepting network requests in no time.

Afterward we will take a look at a tool that provides similar functionality but with a modern and easy-to-use UI.

Step 1: Download and Install Charles Proxy

  • Visit the official website: Head over to the Charles Proxy website and download the appropriate version for your operating system (Windows, macOS, or Linux).
  • Run the installer: Follow the installation wizard prompts. On macOS, you may need to drag the app into the Applications folder. For Windows, follow the standard installation steps.
  • Launch Charles Proxy: Once installed, open Charles Proxy. You’ll be greeted with a trial version screen if you haven’t purchased a license.

Step 2: Set Up SSL Proxying

Charles Proxy allows you to inspect HTTPS traffic as well. Here’s how to set it up:

Enabling SSL Proxying in Charles

  • Open Charles Proxy.
  • Go to the Proxy menu and select SSL Proxying Settings.
      • In the pop-up window, click Add in the Include section to specify the domains you want to decrypt.
      • You can choose to decrypt traffic from all domains (by entering *) or specify certain domains like api.example.com.
    • Click OK to save your settings.

    Install the Charles Root Certificate

    To inspect HTTPS traffic, Charles needs to act as a trusted certificate authority (CA). This requires installing a root certificate on your system or device.

      On Windows

      1. Go to Help > SSL Proxying > Install Charles Root Certificate.

      1. A certificate installation window will appear here Click “ Install Certificate”
      1. Now select between “Current User” or “Local Machine” as you prefer.

      On Mac

      1. Go to Help > SSL Proxying > Install Charles Root Certificate.

      1. The Keychain Access window will open up. here select Charles proxy certificate
      1. Now click the “ When using this certificate” dropdown and select “ Always Trust “.

      On Linux

      1. Go to Help > SSL Proxying > Install Charles Root Certificate.

      1. Your browser will download the certificate. Open the file, and the system will prompt you to install it.

      Step 4: Capture Network Traffic

      • Start capturing traffic: Once the proxy settings are configured, go back to Charles Proxy, and hit the record button (the red dot) to start capturing requests.
      • View traffic: As you browse the web or use apps, you’ll start seeing requests and responses in Charles’s main window. You can filter, inspect, and export this data for debugging purposes.

      Requestly: An Easier Alternative to Charles Proxy

      Requestly offers an easier, browser-based alternative for users who find Charles Proxy complex. It provides similar functionality through a more user-friendly interface, making it ideal for quick web traffic modifications without the need for advanced setup. Unlike Charles Proxy, which lacks a Chrome Extension, Requestly offers extensive functionality directly as a browser extension, along with a standalone desktop app for more advanced use cases. For every feature in Charles Proxy, there’s a corresponding tool in Requestly, such as redirecting URLs, modifying headers, and blocking requests.

      Check out our other blogs on Charles proxy tools to see the comparison

      Conclusion

      Setting up Charles Proxy allows you to inspect and debug network traffic in real-time, making it an invaluable tool for developers and testers. By following the steps outlined in this guide, you should be able to set up Charles Proxy and start capturing HTTP/S traffic quickly.

      Written by
      Dinesh Thakur
      Dinesh Thakur, fascinated by technology since childhood, has mastered programming through dedication. Whether working solo or in a team, he thrives on challenges, crafting innovative solutions.

      Related posts

      How to use access token from another API response
      Learn how to capture, store, and reuse API authentication tokens in Requestly. Simplify authentication by using environment variables and collection authorization.
      Dinesh Thakur
      February 24, 2025
      Organized 125k APIs and improved productivity by 20% using the Requestly API Client: Cyrisma
      Cyrisma improved API management with Requestly’s API client, boosting security, reducing errors, and accelerating development. Learn how they did it
      Sagar Soni
      February 19, 2025
      How to Test FastAPI Efficiently with Requestly API Client
      Learn how to test FastAPI APIs with Requestly API Client for easy debugging, request modifications, and automation. Take control over your API testing workflow!
      Dinesh Thakur
      February 13, 2025