Debugging and Logs

If Mole is not connecting, the first thing to check is the diagnostics section.

Log Console

Opened from Settings → Diagnostics → View logs.

Level filter:

• All: the unfiltered stream.
• Error: critical errors (server unreachable, auth failure).
• Warning: warnings (high latency, DNS timeouts).
• Info: connection progress (handshake, routing).

Common Errors

TLS handshake failed

• Cause: Incorrect date/time on the device or SNI blocking.
• Solution: Synchronize the time. If SNI is blocked, enable TLS Fragmentation in the settings.

DNS resolution failed

• Cause: The provider is blocking your DNS server.
• Solution: Change the DNS protocol to DoH (Google/Cloudflare) in the Mole settings.

Exporting Logs

You can copy the entire log to the clipboard or share it via messengers. This is necessary when contacting your provider's support.