Clash Meta HubClash Meta HubMihomo client hub
Choose language

Troubleshooting

Client will not start: troubleshooting order

Check source and architecture, port conflicts, profile format, permissions, and logs, in that order.

Content reviewed · Nov 3, 2026

Who it is for

Users whose client does nothing on double-click, errors out at launch, or hangs while loading a profile.

Prerequisites

  • The client name and version
  • The error text or a log excerpt
  • Where the installer came from

Troubleshooting steps

  1. 1

    Confirm the installer source and architecture first; that is the most common cause.

  2. 2

    Check for a second instance still running, including one hidden in the tray.

  3. 3

    Check whether the port is taken; default ports often collide with other proxy tools.

  4. 4

    Start with a minimal profile. If it launches, the problem is in your original profile.

  5. 5

    Finally read the log and search official issues using the error keywords.

Common issues

Nothing happens on double-click

Look for a leftover process in Task Manager, end it, and retry. If nothing changes, try a minimal profile.

Profile parse error

YAML indentation or a bad field. Compare against an official example instead of editing unknown keys.

Next step

Confirm the version and supported platform instead of staying on a mismatched build.

Read next:Clash Verge Rev vs Clash Light

This site is an independent Clash Meta / Mihomo ecosystem hub and is not affiliated with the related open-source projects.

Download links point to official GitHub Releases or official websites whenever available.