Proxyman Documentation
HomepagePricingBlogDownload
Search…
Overview
Changelog
License
License Manager
Proxyman iOS
Proxyman for iOS
Debug on Devices
macOS
iOS Device
iOS Simulator
Android Device & Emulator
Firefox
Java VMs
Python
Ruby
React Native
Flutter
Atlantis
Atlantis for iOS
BASIC FEATURES
Proxyman Proxy Helper Tool
Request / Response Previewer
SSL Proxying
Import / Export
Content Filter
Multiple Tabs
Horizontal/Vertical/Window Layout
Copy as
Custom Previewer Tab
Custom Header Column
Regex (Regular Expression)
Filter JSON Response
Highlight by Color and Add Comment
Import / Export Settings
Multipart Form-Data Previewer
JSONPath
Customize Toolbar
ADVANCED FEATURES
Repeat
Edit & Repeat
Compose new Request
No Caching
Breakpoint
Map Local (File)
Map Local (Directory)
Map Remote
External Proxy
Save Session
Protobuf
WebSocket
Clear Session
Block List
Allow List
Charles Proxy Converter
Custom Certificates
GraphQL
Network Conditions
Multiple Filters
Publish to Gist
Reverse Proxy
Code Generator
Scripting
Scripting
Addons
Built-in JS Libraries
Write your own Addons
Snippet Code
Environment Variables
Troubleshooting
Proxyman does not work with VPN apps
My Remote Devices (iOS/Android) could not connect to Proxyman?
SSL Error from HTTPS Request/Response
I could not see any requests from my localhost server
*.local requests do not appear on Proxyman
I couldn't see any traffics on Proxyman
I couldn't see any requests from 3rd-party network libraries
Powered By GitBook
iOS Simulator
How to install Proxyman Certificate to iOS Simulators
In order to capture the HTTP/HTTPS message from your iOS Simulator devices, please navigate to:
  • Certificate Menu -> Install Certificate on iOS -> Simulators

iOS Simulator Setup Guide

It works for iOS, iPadOS, tvOS and watchOS.
The following photo describes three steps:
  1. 1.
    Install Root Proxyman Certificate on your machine: You can follow the macOS Guide.
  2. 2.
    Install Proxyman Certificate to all available simulators, which you have opened at least one time.
  3. 3.
    Reset the Simulator: Proxyman tries to reset all simulators, so it will load the new Certificate.
From Proxyman 2.19.0+, Proxyman uses the simctl command line to perform tasks.
simctl is a built-in on your installed Xcode, which is modern and reliable than the legacy approach (Use custom scripts). If simctl doesn't work, you can switch back to the legacy in Preference -> Advanced Tab -> Use the `simctl` for iOS Simulators.
This step only installs on Simulators, which you have open at least one time
For instance, if you would like to debug on iPhone X Simulator, please make sure to open the iPhone X Simulator first, then installing the Certificate in Step 2

Troubleshooting

1. I am still unable to see HTTPS Response and get SSL Error from my iOS Simulator

  • Opening the Setting app -> General -> About -> Certificate Trust Settings and verify that Proxyman Certificate is installed and trusted
Proxyman Certificate is installed and trusted properly
If it's not installed, please open the iOS Simulator Setup (Certificate Menu -> Install Certificate on iOS -> Simulator) and click on the 2nd button.
If it does not work again, please try using Legacy Code in Proxyman Preference -> Advanced -> Un-check `Use simctl for iOS Simulator` then trying again.

Alternative approach

If you could not install the certificate, you can manually do it:
  1. 1.
    Export the Proxyman Certificate: Certificate Menu -> Export Proxyman Certificate -> Select Desktop folder and Save
  2. 2.
    Open the Simulator and drag the certificate and drop it on the Simulator screen
  3. 3.
    Quit the Simulator and re-open

SSL Proxying

After the installation, we can start capture and view HTTPS messages by following SSL Proxying Doc ​

Tutorial

See detailed steps to debug an application on iOS Simulator with Proxyman
Debug on Devices - Previous
iOS Device
Next - Debug on Devices
Android Device & Emulator
Last modified 4mo ago
Copy link
Contents
iOS Simulator Setup Guide
Troubleshooting
Alternative approach
SSL Proxying
Tutorial