Back to Dashboard

Local Probe Agent

Run diagnostic checks from your own device using our lightweight agent.

Download Agent

Download for Unknown

Version v0.2.10 • Binary executable • No installation required

macOS•Linux•Windows•Android

Installation Guide

1

Download and Unzip

Download the binary. If it's a zip file, extract it. Move the `conncheker-probe-v0.2.10-darwin-*` file to a folder you prefer (e.g., Downloads or a `tools` folder).

2

Make Executable

Open your Terminal application and run the following command to make the binary executable:

chmod +x ~/Downloads/conncheker-probe-v0.2.10-darwin-arm64

"Unverified Developer" Warning

Apple blocks apps from unidentified developers by default. Because this is an open-source tool signed with a self-generated certificate (or unsigned), you will see a warning.

3

Bypass Gatekeeper (Right-Click Method)

The easiest way to bypass the 'Unverified Developer' warning:

  • Open Finder and locate the file.
  • Right-click (or Control-click) the file and select Open.
  • In the dialog that appears, click Open again.
  • You only need to do this once.
4

Bypass Gatekeeper (CLI Method)

Alternatively, you can remove the quarantine attribute using the terminal:

xattr -d com.apple.quarantine ~/Downloads/conncheker-probe-v0.2.10-darwin-arm64
5

Run the Agent

Now you can run the agent from your terminal. Keep the terminal window open.

~/Downloads/conncheker-probe-v0.2.10-darwin-arm64

Common Issues & Troubleshooting

Why does the agent show "Offline" on HTTPS?

The probe agent runs locally on your device using plain WebSocket (ws://127.0.0.1:18923). When you access ConnCheker via HTTPS, your browser blocks this connection due to Mixed Content security — HTTPS pages cannot load insecure (HTTP/WS) resources by default. You need to explicitly allow insecure content for this site.

🌐 Google Chrome

Method 1: Site Settings (Recommended)

  1. Click the Tune icon (slider icon) or Lock icon in the address bar (left of the URL).
  2. Click "Site settings".
  3. Scroll down to "Insecure content".
  4. Change from "Block" to "Allow".
  5. Go back to ConnCheker and refresh the page.

Method 2: Direct URL (Fastest)

Paste this into your Chrome address bar:

chrome://settings/content/siteDetails?site=https://connchecker.prslabs.net

Then change "Insecure content" to "Allow" and refresh.

🔷 Microsoft Edge

  1. Click the Lock icon in the address bar.
  2. Click "Permissions for this site".
  3. Find "Insecure content" and set it to "Allow".
  4. Refresh the page.

🦊 Mozilla Firefox

Firefox handles this differently — WebSocket connections to localhost / 127.0.0.1 are generally allowed by default on HTTPS pages. If it still doesn't work:

  1. Click the Shield icon in the address bar.
  2. Click "Connection secure" → "More information".
  3. Go to "Permissions" tab and check for any blocked content.
  4. Alternatively, type about:config and set network.websocket.allowInsecureFromHTTPS to true.

🧭 Safari (macOS)

Safari does not have a per-site "Insecure content" setting. Instead:

  1. Use the local development URL (http://localhost:3000) instead of the HTTPS production URL.
  2. Or use Chrome or Firefox for production access with the local agent.

Still Offline? Check the Agent

If you've allowed insecure content but the agent is still offline, the agent process itself may not be running or your firewall may be blocking port 18923.

Quick test:

Open http://127.0.0.1:18923 in your browser directly.

  • Shows a page (even an error page like "Upgrade Required") → Agent is running ✅
  • "This site can't be reached" → Agent is not running or blocked ❌