DevPeek

FAQ

Common install and day-to-day issues. If you’re still stuck, contact support through the channel where you obtained DevPeek.

macOS / Linux desktop

DevPeek desktop is Windows-only for now. macOS and Linux builds are coming soon—watch this site’s homepage download or changelog.

Why does Debug stay on “Waiting for device connection”?

Common causes: the device is not using DevPeek as its proxy, the phone has not download and trust the DevPeek root CA (HTTPS cannot be decrypted or injected), the host is outside the SSL allowlist, or the current page is not injectable one HTML document response. Confirm decrypted HTML responses for that client in Capture, then pick its client tab in Debug and refresh the target page on the phone.

When the connection fails, the in-page DevPeek debug popup lists candidate WebSocket addresses and status—handy on multi-NIC PCs to verify the correct IP.

DevPeek in-page debug popup: addresses and connection status
Inject popup · connection check

Why are scripts/styles missing in preview?

Preview honors the site’s CSP; blocked resources fail in the mirror by design—compare on a real device if unsure.

SSL is `*` but I still see tunnels

Confirm the client points at DevPeek and that SSL proxy enabled is on. Hosts outside the allowlist or traffic that bypasses the proxy (e.g. some HTTP/3 paths) may stay encrypted.

Mock not working?

  • Is at least one rule enabled under Proxy → Start Mock? Is the sidebar Mock panel on?
  • Manual Mock: check request / response stages; auto Mock: fill in tamper content.
  • Is recording on? Is the client tab in list pause? For encrypted params, configure param transform first.

Auto-update fails

Check network access to the vendor’s update endpoint; some internal/offline builds ship without auto-update. Disk permissions, free space, or security tools can also block downloads.

Extension cannot reach desktop DevPeek

Ensure DevPeek is running and firewalls allow loopback to the collaboration port. If you changed the collaboration HTTP port, set the same value in the extension popup. Escalate via your vendor channel if it persists.

Compliance

DevPeek can decrypt, rewrite, and forward traffic on your behalf. Use it only on systems you are allowed to test

Read more

Back to docs home or download home.