Charles Proxy is a web proxy (HTTP Proxy / HTTP Monitor) that runs on your computer. You can configure your web browser or other Internet application to access the Internet through Charles so that Charles records all the data sent and received. Analyzing that data helps you to diagnose and fix problems.
- Open your browser
- Navigate to http://www.charlesproxy.com/download/
Be sure to review any release notes and warnings on the Charles web download page that might apply to your browser or operating system.
- Choose the download for your operating system and launch the setup file.
- Firefox requires an additional install also found at http://www.charlesproxy.com/download/. Verify the installation by clicking the accordion button, choose Add-ons, click Extensions. Charles Auto-configuration appears in the list of extensions.
Enabling SSL Proxy Settings
The following instructions are for the most popular browsers to help you trust your Charles Root Certificate so you do not see certificate warnings.
If you choose to permanently trust each site’s certificate as you encounter them, you can skip this section.
Navigate to http://www.charlesproxy.com/documentation/using-charles/ssl-certificates/ for full instructions for your browser and operating system.
- Launch Chrome and navigate to Settings.
- Scroll down and select Show advanced settings....
- Scroll to the HTTPS/SSL section and click Manage certificates....
- Go to the Trusted Root Certification Authorities tab and click Import.
- Find the certificate file you saved when you installed Charles
- Click Next and accept the default options.
- Click Finish.
- Launch Firefox.
- Click Tools on the menu bar.
If the menu bar is missing, click the accordion button and click Customize. Select Show/Hide Toolbars.
- Select Charles Proxy.
- Choose Install Charles Root Certificate .
Mac OS X
Allow Charles to auto-configure your Mac OS X proxy. You will need administrator access to your computer and the administrator password. Once configured, Charles can record all non-Firefox traffic, that is, Internet Explorer, Safari, and Chrome.
Windows and Internet Explorer
- Launch Charles.
- Click Help on the menu bar.
- Choose SSL Proxying.
- Click Install Charles Root Certificate.
- Click Install Certificate.
- Import the certificate into the “Trusted Root Certification Authorities” certificate store, you must override the automatic certificate store selection.
- You might need to restart IE to complete the installation.