Useful articles
Common errors
The error text, what it means, and how to fix it. Every fix works without Solpuga.
- WebSocket closed with code 1006 — how to find the causeThe connection died with no Close frame. Four causes, and how to tell them apart.
- Android does not trust the proxy certificateApps built for Android 7+ ignore user-installed CAs. How to allow them in a debug build with network_security_config, and what it will not fix.
- iOS: profile installed, certificate not trustedOn iOS a root certificate takes two steps, not one. The second one is hidden under About, and nothing works without it.
- ERR_CERT_AUTHORITY_INVALID through a proxy — how to fix itChrome does not trust the proxy's root certificate. Where to install it on macOS, Windows and Linux, and why Firefox ignores the system store.
- How to see the traffic from an iPhone or an Android phonePhone and computer on one Wi-Fi, a proxy in the network settings, a root certificate with full trust. Four steps, and the six things that break them.
- SSE arrives in one chunk: nginx bufferingServer-Sent Events land all at once instead of streaming. Three layers hold them: proxy_buffering, gzip and the app itself. How to test each.
- The stream dies after 60 seconds: proxy_read_timeoutA stream that dies on the same second is a timeout, not the network. Default values in nginx, ALB, Cloudflare, Heroku and Envoy, and why a heartbeat is safer.
- Replacement characters «�» in a stream: TextDecoderA multi-byte character was cut at a chunk boundary. One decoder and one flag fix it, and the same mistake is hiding one level up, in the SSE parsing.
- The seventh tab never loads: the six-connection limitA browser opens at most six HTTP/1.1 connections per origin. One EventSource holds one of them forever, so the seventh tab just waits.
- How to mock an API response without touching the backendFour ways to hand an app your own JSON: Chrome Local Overrides, MSW, a client interceptor and a proxy, and when each one fits.
What maps to what, and how to carry recorded sessions over as HAR.
- Migrating from Charles Proxy to SolpugaA map of Charles's tools onto Solpuga's and how to carry a recorded session over as HAR: what travels, what is lost, and the limits.
- Migrating from Proxyman to SolpugaA map of Proxyman's tools onto Solpuga's and carrying a session over as HAR: what travels, what is lost, and the limits.
- Migrating from Fiddler to Solpuga: Classic and EverywhereFiddler is two different products and you leave them for different reasons.