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:

1. Enable SSL proxy in Charles Proxy.
2. Export the certificate from Charles Proxy into a file named proxy-cert.pem.
3. Add certificate to assets/raw directory.
4. Set enableSSLProxying to true.
5. 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:

1. Open Charles Proxy.
2. Go to the Proxy tab.
3. Locate the macOS Proxy setting.
4. 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