# Proxyman Documentation

> Official documentation for Proxyman, the HTTP debugging proxy for macOS, Windows, Linux, iOS and Android. It covers installing and trusting the Proxyman certificate, capturing HTTP/HTTPS traffic from apps, browsers, simulators, emulators, physical devices and backend code, and debugging tools such as Breakpoint, Map Local, Map Remote, Scripting, Network Conditions, the command line and MCP for AI agents.

Every page below is available as Markdown: add `.md` to its URL, as linked here. The rendered pages are at the same URLs without `.md`. For the whole documentation in a single file, read https://proxyman.com/docs/llms-full.txt. For the Proxyman website, pricing and product overview, read https://proxyman.com/llms.txt.

These docs used to live at https://docs.proxyman.com. Old links redirect to the same path under https://proxyman.com/docs.

## Getting Started

- [Overview](https://proxyman.com/docs/index.md): Proxyman is an HTTP debugging proxy for macOS, Windows, Linux, iOS and Android. Capture, inspect and change HTTP/HTTPS traffic from apps and devices.
- [Changelog](https://proxyman.com/docs/changelog.md): Read the Proxyman changelog and release notes for macOS, Windows and Linux, and download an older version of the Proxyman app when you need one.
- [License](https://proxyman.com/docs/license.md): Learn what Proxyman Pro includes, how the trial works, and how to buy, activate, move or remove a Proxyman license key on Mac, Windows, Linux and iOS.
- [License Manager](https://proxyman.com/docs/license-manager.md): Use the Proxyman License Manager to check your license status, renew or extend your key, and remove old Mac or iOS devices from your seats.
- [Raycast](https://proxyman.com/docs/raycast.md): Control Proxyman from Raycast. Install the Proxyman Raycast extension to toggle the system proxy, debugging tools and recording with a few keystrokes.
- [Command-line](https://proxyman.com/docs/command-line.md): Use proxyman-cli to control Proxyman for macOS from Terminal: export and import rules, toggle tools and the system proxy, export logs and manage certs.
- [MCP](https://proxyman.com/docs/mcp.md): Connect Codex, Claude Code, or Cursor to Proxyman MCP to inspect captured HTTP/HTTPS traffic and create debugging rules from your AI assistant.
- [SKILL.md](https://proxyman.com/docs/skill-md.md): Install the official Proxyman agent skills (SKILL.md) for Codex, Claude Code, Cursor and Copilot to inspect, replay and debug HTTP/HTTPS traffic.
- [Security Compliance](https://proxyman.com/docs/security-compliance.md): Proxyman is SOC 2 Type 2 compliant. Learn what the audit covers, what it means for customers and resellers, and where to find Proxyman security policies.

## Team Workspace

- [Team Workspace](https://proxyman.com/docs/team-workspace/team-workspace.md): Use Proxyman Team Workspace to invite teammates, give them Admin or Developer roles, track seat usage and share licenses and logs with your team.
- [Share Log online](https://proxyman.com/docs/team-workspace/share-log-online.md): Share Proxyman logs and HAR files with your team online. Upload from the Proxyman app or Workspace, add notes, redact secrets and control who can view.

## Proxyman iOS

- [Proxyman for iOS](https://proxyman.com/docs/proxyman-ios/vpn-and-proxyman-certificate.md): Proxyman for iOS captures and decrypts HTTP and HTTPS traffic on your iPhone or iPad with a local VPN, with no Mac needed. See features and setup.
- [Map Local for iOS](https://proxyman.com/docs/proxyman-ios/map-local-for-ios.md): Use Map Local in Proxyman for iOS to return a custom status code, headers and body for matching requests, so you can mock APIs right on your iPhone.
- [Breakpoint for iOS](https://proxyman.com/docs/proxyman-ios/breakpoint-for-ios.md): Use Breakpoint in Proxyman for iOS to pause a request or response on your iPhone and edit its URL, method, status code, headers and body on the fly.
- [Tutorial for iOS](https://proxyman.com/docs/proxyman-ios/tutorial-for-ios.md): Step-by-step tutorials for Proxyman for iOS: mock responses with Map Local and edit requests and responses with Breakpoint on your iPhone.
- [Map Local for iOS Tutorial](https://proxyman.com/docs/proxyman-ios/tutorial-for-ios/map-local-for-ios-tutorial.md): Step-by-step tutorial: mock HTTP/HTTPS responses on your iPhone with Proxyman for iOS Map Local and change the status code, headers and body.
- [Breakpoint for iOS Tutorial](https://proxyman.com/docs/proxyman-ios/tutorial-for-ios/breakpoint-for-ios-tutorial.md): Step-by-step tutorial: use Proxyman for iOS Breakpoint to pause traffic on your iPhone and edit the URL, method, headers, body and status code.

## Debug on Devices

- [macOS](https://proxyman.com/docs/debug-devices/macos.md): Install and trust the Proxyman CA certificate on macOS, verify HTTPS capture, or use manual Keychain setup when automatic installation fails.
- [iOS Device](https://proxyman.com/docs/debug-devices/ios-device.md): Capture iPhone and iPad HTTP/HTTPS traffic with Proxyman on your Mac: set the Wi-Fi proxy, then install and trust the Proxyman certificate on the device.
- [iOS Simulator](https://proxyman.com/docs/debug-devices/ios-simulator.md): Capture iOS Simulator HTTP/HTTPS traffic with Proxyman on macOS, using automatic certificate setup, manual installation, and missing-traffic checks.
- [tvOS & watchOS](https://proxyman.com/docs/debug-devices/tvos-and-watchos.md): Set up Apple TV and Apple Watch simulators or real devices with Proxyman to capture and inspect HTTP/HTTPS requests and responses from tvOS and watchOS.
- [Android Device & Emulator](https://proxyman.com/docs/debug-devices/android-device.md): Capture Android device and emulator HTTP/HTTPS traffic with desktop Proxyman, including proxy setup, certificates, automatic scripts, and Google Play images.
- [Automatic Script for Android Emulator](https://proxyman.com/docs/debug-devices/android-device/automatic-script-for-android-emulator.md): Use the Proxyman automatic script to set the HTTP proxy and install the Proxyman certificate on Android Emulators, so you can capture HTTPS in one click.
- [Google-Play Android Emulator with Magisk](https://proxyman.com/docs/debug-devices/android-device/google-play-android-emulator-with-magisk.md): Root Google Play Android Emulators with Magisk in one click from Proxyman, so Proxyman can install its certificate and capture HTTPS from your Android app.
- [Sample Android Project](https://proxyman.com/docs/debug-devices/android-device/sample-android-project.md): Download a sample Kotlin Android project with OkHttp that shows how Proxyman captures and decrypts HTTPS traffic from an Android app or emulator.
- [Firefox](https://proxyman.com/docs/debug-devices/firefox.md): Capture HTTPS requests and responses from the Firefox browser with Proxyman, using 1-click Automatic Setup or by installing the Proxyman CA in Firefox.
- [Java VMs](https://proxyman.com/docs/debug-devices/java.md): Install the Proxyman Root CA certificate into all Java KeyStores on macOS with one script, so Proxyman can capture HTTPS traffic from Java and Kotlin apps.
- [Python](https://proxyman.com/docs/debug-devices/python.md): Capture HTTP/HTTPS traffic from Python scripts and servers with Proxyman Automatic Setup. Works with requests, http.client, urllib3, httpx and aiohttp.
- [Ruby](https://proxyman.com/docs/debug-devices/ruby.md): Capture HTTP/HTTPS traffic from Ruby scripts and servers with Proxyman Automatic Setup. Works with http, net/http, net/https, httparty and faraday.
- [NodeJS](https://proxyman.com/docs/debug-devices/nodejs.md): Capture HTTP/HTTPS traffic from NodeJS apps and scripts with Proxyman Automatic Setup. Works with axios, got, superagent, fetch and node-fetch.
- [Rust](https://proxyman.com/docs/debug-devices/rust.md): Configure the proxy and certificate handling for Rust reqwest requests so their HTTP/HTTPS traffic appears in Proxyman.
- [Golang](https://proxyman.com/docs/debug-devices/golang.md): Capture HTTP/HTTPS traffic from Go apps with Proxyman Automatic Setup. Works with net/http, fasthttp, resty, gorequest, req and grequests.
- [React Native](https://proxyman.com/docs/debug-devices/react-native.md): Capture HTTPS traffic from React Native and Expo apps with Proxyman on iOS devices, iOS Simulators, Android devices and Android Emulators.
- [Flutter](https://proxyman.com/docs/debug-devices/flutter.md): Capture HTTPS traffic from Flutter apps with Proxyman on Android Emulators, Android devices, iOS Simulators and iPhones, with or without code changes.
- [HTTP Clients](https://proxyman.com/docs/debug-devices/http-clients.md): Configure Postman, Insomnia, and Paw to send HTTP/HTTPS traffic through Proxyman and troubleshoot certificate errors.
- [Docker](https://proxyman.com/docs/debug-devices/docker.md): Capture HTTP/HTTPS traffic from Docker services and configure containers to route outgoing requests through Proxyman.
- [ElectronJS](https://proxyman.com/docs/debug-devices/electronjs.md): Capture HTTP/HTTPS traffic from ElectronJS apps with Proxyman in one click, even when the app ignores the system proxy. No source code changes needed.
- [NextJS (fetch)](https://proxyman.com/docs/debug-devices/nextjs-fetch.md): Capture HTTPS requests from Next.js server-side fetch() and Server Components with the Proxyman pre-configured Terminal from Automatic Setup.
- [Demo iOS & Android](https://proxyman.com/docs/debug-devices/demo-ios-and-android.md): Watch Proxyman demo videos that capture HTTPS from native and React Native apps on iOS Simulators and Android Emulators, with sample projects.

## Automatic Setup

- [Automatic Setup](https://proxyman.com/docs/automatic-setup/automatic-setup.md): Use Proxyman Automatic Setup to open a pre-configured Terminal and capture HTTP/HTTPS traffic from NodeJS, Python, Ruby, Golang and cURL in one click.
- [Manual Setup](https://proxyman.com/docs/automatic-setup/manual-setup.md): Use Proxyman Manual Setup to capture HTTPS traffic from NodeJS, Python, Ruby and cURL in your own Terminal app, such as iTerm2, with Bash, Zsh or Fish.
- [Troubleshooting](https://proxyman.com/docs/automatic-setup/troubleshooting.md): Fix common Proxyman Automatic Setup and Manual Setup problems: missing traffic from NodeJS, Python or Ruby, SSL errors, and localhost requests.

## Atlantis

- [Atlantis for iOS](https://proxyman.com/docs/atlantis/atlantis-for-ios.md): Use the Atlantis iOS framework to send HTTP/HTTPS and WebSocket traffic from your app to Proxyman for macOS, without proxy or certificate setup.

## BASIC FEATURES

- [Proxyman Proxy Helper Tool](https://proxyman.com/docs/basic-features/proxy-setting-tool.md): Install the Proxyman Proxy Helper Tool to change and restore the macOS system proxy faster, and to let guest or non-admin users capture traffic.
- [Request / Response Previewer](https://proxyman.com/docs/basic-features/request-response-viewer.md): Inspect requests and responses in Proxyman with Header, Cookies, Query, Body, Raw and JSON Tree View tabs, and arrange the panels to fit your work.
- [Connection Log](https://proxyman.com/docs/basic-features/connection-log.md): Use the Proxyman Connection Log to inspect DNS lookups, TCP connections, TLS handshakes, certificates, and HTTP headers for each request.
- [SSL Proxying](https://proxyman.com/docs/basic-features/ssl-proxying.md): Set up SSL Proxying in Proxyman to decrypt and inspect HTTPS traffic from selected apps and domains, using host names or wildcard rules.
- [HTTP/2](https://proxyman.com/docs/basic-features/http2.md): Turn on HTTP/2 in Proxyman for macOS to capture HTTP/2 traffic and inspect requests, responses, trailers, and the negotiated protocol.
- [Bypass Proxy List](https://proxyman.com/docs/basic-features/bypass-proxy-list.md): Use the Proxyman Bypass Proxy List to choose domains that skip the proxy, with wildcard matching, so you can hide noise and avoid SSL pinning errors.
- [Import / Export](https://proxyman.com/docs/basic-features/import-export.md): Import and export traffic in Proxyman: open Proxyman Log, HAR and Charles files, and export requests as Proxyman Log, HAR, CSV or Postman Collection.
- [Content Filter](https://proxyman.com/docs/basic-features/content-filter.md): Use the Proxyman Content Filter to find requests fast by type, status code, URL, header, body and more, with contains, wildcard and regex matching.
- [Tab View](https://proxyman.com/docs/basic-features/multiple-tabs.md): Use Proxyman Tab View on macOS to organize traffic in Safari-style tabs, each with its own source, filters and selected request.
- [Split View](https://proxyman.com/docs/basic-features/split-view.md): Use Proxyman Split View on macOS to compare two traffic panes side by side, each with its own filters, selected request and inspector.
- [Horizontal/Vertical/Window Layout](https://proxyman.com/docs/basic-features/horizontal-vertical-layout.md): Change the Proxyman workspace layout: dock the Request and Response panels to the bottom or right, open them in a separate window, or hide the sidebar.
- [Copy as](https://proxyman.com/docs/basic-features/copy-as.md): Copy requests and responses in Proxyman as a URL, cURL command, Markdown table, CSV or raw text, or copy just the headers, cookies or body.
- [Custom Previewer Tab](https://proxyman.com/docs/basic-features/custom-previewer-tab.md): Add Proxyman Custom Previewer Tabs to show a request or response body as JSON, Protobuf, HTML or MessagePack, or to add the Connection Log tab.
- [Custom Header Column](https://proxyman.com/docs/basic-features/custom-header-column.md): Add custom columns in Proxyman from request or response headers, query parameters, and JSON body values to tell similar requests apart at a glance.
- [Regex (Regular Expression)](https://proxyman.com/docs/basic-features/regex.md): Use Wildcard and Regex matching rules in Proxyman tools such as Map Local and Breakpoint, and test your rule against sample URLs before you save it.
- [Filter JSON Response](https://proxyman.com/docs/basic-features/filter-json-response.md): Filter JSON responses in Proxyman with text search, regex, JSONPath and jq, or show only the keys and values that match in the Treeview tab.
- [Highlight by Color and Add Comment](https://proxyman.com/docs/basic-features/highlight-by-color-and-add-comment.md): Highlight requests in Proxyman with colors or strikethrough, add comments, then filter by color or comment and share the log with your team.
- [Import / Export Settings](https://proxyman.com/docs/basic-features/import-export-settings.md): Back up and share Proxyman settings and debugging rules, import rules from Proxyman or Charles Proxy, and open Charles Proxy session files.
- [Multipart Form-Data Previewer](https://proxyman.com/docs/basic-features/multipart-form-data-previewer.md): Inspect each part of a multipart/form-data request in the Proxyman Multipart tab, preview its content, and save any part to a file on your Mac.
- [JSONPath](https://proxyman.com/docs/basic-features/jsonpaths.md): Query JSON request and response bodies in Proxyman with JSONPath. Learn the syntax, filter operators, and path examples you can copy.
- [JQ](https://proxyman.com/docs/basic-features/jq.md): Filter and transform JSON request and response bodies in Proxyman with jq in the JSON and Treeview tabs. Learn how to open the JSON tab and use jq.
- [Customize Toolbar](https://proxyman.com/docs/basic-features/customize-toolbar.md): Customize the Proxyman toolbar on macOS with buttons that turn tools such as Breakpoint, Map Local, and Scripting on or off with one click.
- [Localization](https://proxyman.com/docs/basic-features/localization.md): Change the Proxyman app language to English, Chinese, Japanese, Portuguese, or Spanish, and help improve the app translations on GitHub.
- [Quick Preview](https://proxyman.com/docs/basic-features/quick-preview.md): Use Proxyman Quick Preview on selected text to prettify JSON or XML, decode Base64 and JWT tokens, convert timestamps, and show key-value tables.
- [Command Palette](https://proxyman.com/docs/basic-features/command-palette.md): Open the Proxyman Command Palette with ⌘P to search and toggle debugging tools, open setup guides, and pin the actions you use most.

## ADVANCED FEATURES

- [Network Extension](https://proxyman.com/docs/advanced-features/network-extension.md): Use Proxyman Network Extension to capture HTTP and HTTPS traffic from every app on your Mac, including apps and scripts that ignore proxy settings.
- [Repeat](https://proxyman.com/docs/advanced-features/repeat.md): Use Proxyman Repeat to resend a captured HTTP or HTTPS request with the same headers and body, so you can check the latest server response fast.
- [Edit & Repeat](https://proxyman.com/docs/advanced-features/edit-and-repeat.md): Use Proxyman Edit & Repeat to change the URL, query, headers, or body of a captured HTTP request, send it again, and check the new response.
- [Compose new Request](https://proxyman.com/docs/advanced-features/compose.md): Use Proxyman Compose to build and send HTTP or HTTPS requests to your API, import cURL commands, and inspect the response, like a simple Postman.
- [No Caching](https://proxyman.com/docs/advanced-features/no-caching.md): Use Proxyman No Caching to strip and override cache headers, so your app always gets the latest HTTP response from the server instead of a cache.
- [Breakpoint](https://proxyman.com/docs/advanced-features/breakpoint.md): Use Proxyman Breakpoint to pause HTTP requests and responses and edit the URL, headers, status code, or body on the fly before they continue.
- [HTTP Message Templates](https://proxyman.com/docs/advanced-features/breakpoint-templates.md): Create Proxyman Breakpoint Templates for requests and responses, then apply a saved HTTP message in the Breakpoint Raw tab with one click.
- [Map Local (File)](https://proxyman.com/docs/advanced-features/map-local.md): Use Proxyman Map Local to return a local file as the response for a request, with your own status code, headers, and body, so you can mock APIs fast.
- [Map Local (Directory)](https://proxyman.com/docs/advanced-features/map-local-directory.md): Use Proxyman Map Local Directory to serve matching requests from files in a local folder, and fall back to the server when a file is missing.
- [Map Remote](https://proxyman.com/docs/advanced-features/map-remote.md): Use Proxyman Map Remote to redirect matching HTTP, HTTPS, and WebSocket requests to another host, port, or path, such as localhost or staging.
- [External Proxy](https://proxyman.com/docs/advanced-features/external-proxy.md): Use Proxyman External Proxy to send HTTP and HTTPS traffic through your company HTTP, HTTPS, SOCKS, or PAC proxy, with bypass rules for some hosts.
- [Save Session](https://proxyman.com/docs/advanced-features/save-session.md): Use Proxyman Save Session to save captured requests, responses, apps, domains, and devices to a file you can reopen later or share with teammates.
- [Protobuf](https://proxyman.com/docs/advanced-features/protobuf.md): Decode Protobuf HTTP and HTTPS requests, responses, and WebSocket messages in Proxyman with a .desc file descriptor and a Message Type rule.
- [WebSocket](https://proxyman.com/docs/advanced-features/websocket.md): Capture and decrypt WebSocket (WS/WSS) traffic with Proxyman from web browsers, iOS devices and simulators, Android, and NodeJS or Python servers.
- [Clear Session](https://proxyman.com/docs/advanced-features/clear-session.md): Use Proxyman Clear Session to remove all captured requests, domains, and clients from the current session and free memory without quitting the app.
- [Block List](https://proxyman.com/docs/advanced-features/blacklist.md): Use the Proxyman Block List to block or hide requests by domain, wildcard, regex, or app, so ads, analytics, and noisy pings stay out of your session.
- [Allow List](https://proxyman.com/docs/advanced-features/whitelist.md): Use the Proxyman Allow List to capture only the domains you choose and let all other traffic bypass Proxyman, so you can focus on your own APIs.
- [Charles Proxy Converter](https://proxyman.com/docs/advanced-features/charles-proxy-converter.md): Convert Charles Proxy .chls session files to HAR and open them in Proxyman, so you can keep working with traffic you captured in Charles.
- [Custom Certificates](https://proxyman.com/docs/advanced-features/custom-certificates.md): Add custom root, server, and client certificates to Proxyman for SSL pinning and mutual TLS, and generate a self-signed root certificate Apple trusts.
- [GraphQL](https://proxyman.com/docs/advanced-features/graphql.md): Debug GraphQL requests in Proxyman: match rules by query name, prettify queries, show a Query Name column, and mock responses with scripts.
- [Network Conditions](https://proxyman.com/docs/advanced-features/network-throttling.md): Use Proxyman Network Conditions to simulate slow or lossy networks like 3G, 4G, or poor Wi-Fi for one host or all traffic, and test your app.
- [Multiple Filters](https://proxyman.com/docs/advanced-features/multiple-filters.md): Combine up to 10 Proxyman filters with AND or OR to find requests by URL, host, header, body, status code, method, client, comment, and more.
- [Custom Filters](https://proxyman.com/docs/advanced-features/custom-filters.md): Save your current Proxyman filters as a custom filter button on the filter bar, then reuse, override, rename, or delete it with one click.
- [Publish to Gist](https://proxyman.com/docs/advanced-features/publish-to-gist.md): Publish selected Proxyman requests and responses to a public or private GitHub Gist, so you can share them with your team using one link.
- [Reverse Proxy](https://proxyman.com/docs/advanced-features/reverse-proxy.md): Use Proxyman Reverse Proxy to capture HTTP and HTTPS traffic from apps and command-line tools that ignore the system proxy, via a local port.
- [Code Generator](https://proxyman.com/docs/advanced-features/code-generator.md): Turn captured requests into cURL, Swift, Python, Go, Kotlin, JavaScript, and other code snippets with the Proxyman Code Generator tab.
- [Diff](https://proxyman.com/docs/advanced-features/diff.md): Compare two HTTP requests or responses with the Proxyman Diff tool, side by side or unified, including the URL, headers, status code, and body.
- [Access Control](https://proxyman.com/docs/advanced-features/access-control.md): Use Proxyman Access Control to allow all, block all, or allow only specific IP addresses to connect to your proxy, and set the mode from the CLI.
- [DNS Spoofing](https://proxyman.com/docs/advanced-features/dns-spoofing.md): Use Proxyman DNS Spoofing to send a domain to a different IP address or server while keeping the original URL and Host header unchanged.
- [SOCKS Proxy](https://proxyman.com/docs/advanced-features/socks-proxy.md): Turn on the Proxyman SOCKS5 proxy (port 8889 by default) to capture and debug HTTP and HTTPS traffic from apps that support SOCKS proxies.
- [Swagger OpenAPI](https://proxyman.com/docs/advanced-features/swagger-openapi.md): Export captured Proxyman requests and responses to a Swagger OpenAPI 3.0 YAML file or an HTML page, with no extra tools to install.
- [TLS Key Logging](https://proxyman.com/docs/advanced-features/tls-key-logging.md): Record TLS session keys with Proxyman TLS Key Logging and save them to a file, so you can decrypt HTTPS traffic in Wireshark or TCP Viewer.

## Proxyman Windows

- [Install Certificate](https://proxyman.com/docs/proxyman-windows/install-certificate.md): Install and trust the Proxyman CA certificate on Windows 10 and 11, with the automatic script or by hand, so Proxyman can decrypt HTTPS traffic.
- [WSL](https://proxyman.com/docs/proxyman-windows/wsl.md): Install WSL, Chocolatey (choco) and adb on Windows 10 or 11 so you can use the Proxyman automatic script for Android Emulators.

## Scripting

- [Scripting](https://proxyman.com/docs/scripting/script.md): Use the Proxyman Scripting tool to modify HTTP requests and responses with JavaScript, mock APIs, and log WebSocket messages with onWebsocket.
- [Modify WebSocket Messages](https://proxyman.com/docs/scripting/modify-websocket-messages.md): Edit, drop, or send WebSocket (WS/WSS) messages on the fly with onWebsocket in Proxyman Scripting. Works in both directions, with text and binary messages.
- [async/await Request](https://proxyman.com/docs/scripting/async-await-request.md): Use async/await in Proxyman Scripting to call external HTTP/HTTPS APIs from onRequest and onResponse, with $http on macOS or axios on Windows/Linux.
- [Addons](https://proxyman.com/docs/scripting/addons.md): Browse the built-in Proxyman Scripting addons for Base64, MD5/SHA hashing, UUID, JWT decode, GZip and more, and import them with require().
- [Built-in JS Libraries](https://proxyman.com/docs/scripting/built-in-js-libraries.md): See the JavaScript libraries bundled with Proxyman Scripting, such as lodash, crypto-js and hashes, and learn how to import your own library with require().
- [Use npm install](https://proxyman.com/docs/scripting/use-npm-install.md): Install npm packages such as dayjs or lodash into Proxyman's Application Support folder and use them in Proxyman Scripting with require().
- [Write your own Addons](https://proxyman.com/docs/scripting/write-your-own-addons.md): Write your own JavaScript addon for Proxyman Scripting, save it in the custom addons folder, and import it into any script with require().
- [Snippet Code](https://proxyman.com/docs/scripting/snippet-code.md): Copy ready-to-use JavaScript snippets for Proxyman Scripting: edit headers, queries, JSON bodies and status codes, map local files, call APIs, and more.
- [Environment Variables](https://proxyman.com/docs/scripting/environment-variables.md): Share data between Proxyman scripts with sharedState, and read system environment variables such as API tokens in your scripts with the $ prefix.

## Troubleshooting

- [Proxyman does not work with VPN apps](https://proxyman.com/docs/troubleshooting/proxyman-does-not-work-with-vpn-apps.md): Proxyman not capturing traffic while a VPN is on? See which VPN apps work with Proxyman, and how to set the HTTP proxy for FortiClient, AnyConnect and more.
- [My Remote Devices (iOS/Android) could not connect to Proxyman?](https://proxyman.com/docs/troubleshooting/my-ios-devices-couldnt-connect-to-proxyman-via-proxy.md): iPhone or Android has no internet after setting the Wi-Fi proxy, or can't open proxy.man/ssl? Check the IP, port, VPN and firewall to connect to Proxyman.
- [iOS 16 and iOS 17 issues](https://proxyman.com/docs/troubleshooting/ios-16-devices-issues.md): iPhone ignores the Wi-Fi proxy and Proxyman captures no traffic on iOS 16, 17, 18 or 26? Learn how to test for this iOS bug and fix it with Forget This Network.
- [SSL Error from HTTPS Request/Response](https://proxyman.com/docs/troubleshooting/get-ssl-error-from-https-request-and-response.md): Fix "SSL Handshake Failed" and other SSL errors in Proxyman. Check that the Proxyman certificate is installed and trusted, and rule out SSL pinning.
- [I could not see any requests from my localhost server](https://proxyman.com/docs/troubleshooting/couldnt-see-any-request-from-localhost-server.md): localhost:3000 requests not showing in Proxyman? Capture localhost traffic from Google Chrome with Automatic Setup, or use /etc/hosts or localhost.proxyman.io.
- [I could not see any HTTP traffic from my NodeJS, Python, or Ruby scripts](https://proxyman.com/docs/troubleshooting/i-could-not-see-any-http-traffic-from-my-nodejs-python-or-ruby-scripts.md): NodeJS, Python, Ruby or Golang requests not showing in Proxyman? Capture them with Automatic Setup in one click, or with Network Extension on macOS 26.
- [*.local requests do not appear on Proxyman](https://proxyman.com/docs/troubleshooting/.local-doesnt-appear-in-proxyman.md): *.local requests not showing in Proxyman? Remove *.local from the macOS bypass proxy list, or try Network Extension for local network servers.
- [I couldn't see any traffics on Proxyman](https://proxyman.com/docs/troubleshooting/i-couldnt-see-any-traffics-on-proxyman.md): Proxyman not capturing any requests, or the request list is empty? Check the system proxy, recording, filters, VPN apps and cached responses.
- [I couldn't see any requests from 3rd-party network libraries](https://proxyman.com/docs/troubleshooting/couldnt-see-any-requests-from-3rd-party-network-libraries.md): Requests from axios, fetch, Alamofire, Ktor or cURL not showing in Proxyman? Use Automatic Setup, Network Extension, or set the HTTP proxy in the library.
- [[Breakpoint] Modify Request/Response by Raw Message](https://proxyman.com/docs/troubleshooting/breakpoint-modify-request-response-by-raw-message.md): Fix "Invalid Request HTTP Message" or "Invalid Response HTTP Message" when you edit a raw request or response in the Proxyman Breakpoint Raw tab.
- [Could not change Proxyman App Icons](https://proxyman.com/docs/troubleshooting/could-not-change-proxyman-app-icons.md): Proxyman Dock icon not changing after you pick a new one? Restart the Dock Extra process in Activity Monitor, then select the app icon again.
- [Lost data after updating Proxyman app?](https://proxyman.com/docs/troubleshooting/lost-data-after-updating-proxyman-app.md): Lost your Proxyman rules or settings after an update? Restore Map Local, Scripting, Breakpoint and other data from Proxyman's automatic backup folder.
- [Proxyman consumes too much RAM & unresponsive](https://proxyman.com/docs/troubleshooting/proxyman-consumes-too-much-ram-and-unresponsive.md): Proxyman using too much memory, slow or not responding? Remove * wildcard and web browser rules from the SSL Proxying List and keep auto cleanup on.