Troubleshoot Charles Proxy Issues
This page provides solutions to common issues you might encounter when using Charles Proxy with Vega development tools. Each issue includes the underlying cause and step-by-step resolution instructions. If you don't find a solution to your specific problem here, post an issue in Developer Forum for additional support.
Video streaming issue
Cause: Streaming certain video formats through Charles Proxy causes VDA to fail in USB mode, preventing video data streaming.
Solution: Switch to TCP/IP mode by following the instructions in Enable VDA Over TCP/IP.
SSL certificate issue
Cause: Charles Proxy cannot view HTTPS contents without proper SSL configuration.
Solution:
- Enable SSL proxy in Charles Proxy.
- Export the certificate from Charles Proxy into a file named proxy-cert.pem.
- Add certificate to assets/raw directory.
- Set enableSSLProxying to true.
- Set caBundleFile to raw/proxy-cert.pem.
MacOS-specific SSL issue
Error message:
ERROR: Package 'vegapackagingtool/1.1.7' not resolved: HTTPSConnectionPool(host='k-artifactory-external.labcollab.net', port=443):
Max retries exceeded with url: /artifactory/api/conan/kepler-conan-rc-local/v1/ping
Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED]
certificate verify failed: self-signed certificate in certificate chain (_ssl.c:1000)')))
Cause: macOS Proxy setting in Charles Proxy interferes with system certificate verification, causing SSL errors.
Solution:
- Open Charles Proxy.
- Go to the Proxy tab.
- Locate the macOS Proxy setting.
- Uncheck the macOS Proxy option.
If issue persists:
- Clear certificate cache.
- Uninstall and reinstall your app.
Related topics
- Charles Proxy documentation.
Last updated: Sep 30, 2025