What is a Debug Bundle

What Is a Debug Bundle?

A debug bundle is a ZIP file you can generate from the Obscura app to help us diagnose connection issues, bugs, or other problems.

It collects diagnostic information about your device, network environment, and the Obscura app’s state into a single file you can share with our support team. It does not contain your internet traffic or browsing history.

Debug bundles are never created or sent automatically. You choose when to generate one and who sees it. Since bundles contain information about your device and networking environment, we recommend not sharing them with third parties.

Generate a Debug Bundle

1. Open the Obscura App

2. Select the About tab on mobile or the Help tab on Desktop

3. Click the Orange Create Debug Bundle button

4. The file is saved locally and you choose how to share it

Note

If you’re reporting an issue with Obscura, describe the error you saw in the feedback box when prompted and you can send the debug bundle to support@obscura.net

What’s Included

• App configuration (e.g. DNS settings, tunnel state, enabled features)
• Network connectivity test results (DNS lookups, pings, HTTP checks)
• System information (OS version, device model, hardware details)
• Relevant logs
• Your description of the issue (if you entered one)

What’s Not Included

Debug bundles are designed to only include data for debugging issues with Obscura. The following are never included:

• Your internet traffic
• Your browsing history
• Your personal files

How To Inspect Debug Bundles

Debug bundles are zip files containing plain text files and compressed logs that are designed to be easy to inspect. If you want to take a look for yourself, you can open a bundle and remove anything you’d rather not send. When you unzip the bundle, you’ll find files like:

• info.json - app version, OS version, device model, processor, RAM, thermal state, and uptime
• ne-debug-info.json - app configuration snapshot (cached exits/relays, DNS settings, tunnel state, enabled features)
• system-log.json - filtered system logs (kernel messages, network extension subsystem)
• dig-*.txt, ping-*.txt, http-*.txt - DNS lookups, ping results, and HTTP connectivity tests to public servers and the Obscura API
• ifconfig-*.txt, netstat-*.txt - network interface and routing information
• ne-tunnel-provider-manager.json - VPN connection status, routing method, and on-demand rules

Note

This list is non-exhaustive and the exact contents vary per platform. Our code for generating debug bundles is publicly available. If you have any questions, reach out to support@obscura.net.