Skip to content

Support

Get help with Trace. Find answers in the documentation, report bugs on GitHub, or ask questions in the community.

Common issues

Traffic not being captured

If Trace isn't capturing traffic, check these items:

Ensure capture is started (Network tab, start button)
Verify VPN permission is enabled in iOS Settings
Test with Safari to confirm Trace is working
Some apps bypass system proxy settings and won't be captured
View quick start guide →

HTTPS traffic shows as encrypted

To inspect HTTPS traffic, you need to install and trust the root certificate:

Generate and install the certificate profile in Trace
Enable full trust in Settings > Certificate Trust Settings
Certificate pinning may prevent inspection for some apps
Certificate setup guide →

App crashes on launch or capture

If Trace is crashing, try these troubleshooting steps:

Force quit Trace and reopen the app
Restart your device to clear any stuck state
Delete and reinstall from TestFlight
Check if you're on the latest TestFlight build
Report persistent crashes →

Performance or battery impact

Minimize performance impact while capturing traffic:

Use filtering to capture only relevant traffic
Clear old capture sessions to free memory
Disable modification features you're not using
Stop capture when not actively debugging
Performance tips →

Get help

Documentation

Comprehensive guides for installation, configuration, features, and advanced usage. Start here for detailed explanations and step-by-step tutorials.

Browse documentation →

GitHub Discussions

Ask questions, share tips, and connect with the Trace community. Great for general questions, feature ideas, and debugging help.

Join discussions →

GitHub Issues

Report bugs, request features, or track ongoing work. Include steps to reproduce, device details, and screenshots for bug reports.

Open an issue →

Community

Connect with other Trace users, share debugging workflows, and learn from real-world use cases. Contributions and feedback are always welcome.

Ways to contribute →

Frequently asked questions

Quick answers to common questions about installation, usage, troubleshooting, and privacy.

View all FAQs →

Direct contact

For sensitive issues, security concerns, or press inquiries, reach out directly via email or GitHub.