Material checked on 2026-11-14. Error strings are quoted verbatim so you can match them against your own log.
Decide which of three problems you actually have
| Symptom | Layer | Read next |
|---|---|---|
The home screen keeps showing Install Service, or the install reports program not found | Permissions, service files, installer flow | This page |
| Running Mode already shows Service, but enabling TUN kills connectivity | Virtual adapter, routes, DNS | No internet after enabling TUN |
| Without TUN, the system proxy also cannot reach the internet | Nodes, rules, system proxy | System proxy has no internet |
All three use the same window and the same green/grey switch, but they consume different evidence. Reinstalling or resetting the network across all three destroys the one thing you need most: the original error text.
Save four pieces of evidence before you touch anything
- The exact Clash Verge Rev version and the Windows version.
- Is Admin and Running Mode as shown in
System Infoon the home screen. - The complete error text produced by the service install — specifically whether it contains
program not found. - The Running Mode, Is Admin value and full version number at the moment of failure. Do not attach a private subscription or node list.
The project discussion explicitly recommends judging administrator state from Is Admin: true in System Info, not from remembering that you once right-clicked Run as administrator. That distinction is the whole reason the four items above exist.
Case 1 — System Info still shows Is Admin: false
Official discussion #7475 was filed on Windows 11 with Clash Verge Rev 2.5.1. The reporter stated they had launched the client as administrator, yet the diagnostics still showed Running Mode: Sidecar and Is Admin: false. The accepted answer points out that a genuinely elevated session shows Is Admin: true, and suggests trying a later build of that period and the Service mode.
The only conclusion this record supports: do not infer permissions from the act of clicking Run as administrator — read the diagnostics instead. It does not prove that every version needs the same build, and it does not prove that a single UAC confirmation repairs the service.
Case 2 — the error text contains program not found
Official issue #8138 documents a Windows 11, v2.5.7+autobuild case: installing the service in normal user mode produced program not found. The reporter then fully exited the client, started it as administrator, saw administrator mode confirmed in System Info, and reports that the service installed afterwards.
- Exit the client completely — not just close the window — then start it elevated and confirm the UAC prompt.
- Return to
System Infoand check thatIs Admin: trueis actually displayed. - Attempt the service install once more from that state.
- If it still fails, keep the version, Windows build, Running Mode and verbatim error. Do not try to guess which file is "missing" from the words
program not found. - Take installers only from the official Releases page. The reporter in #7475 later mentioned an old-version conflict remaining after an update; that is a single record, which is why this page does not present "reinstall" as a standard fix.
Case 3 — installation finished without satisfying the requested service and cores
Official issue #8023 was filed on Windows 10 with v2.5.4 and v2.5.5. The error was installation finished without satisfying the requested service and cores, and the log also contained a core path security check. The report establishes only that this error appeared in those versions and that environment.
- First confirm that your error text and version match the issue. A different error must not inherit the same treatment.
- Do not copy the ACL modifications, service deletions or system-directory cleanup described in the thread. Path permissions are a security boundary; changing them incorrectly widens the exposure.
- Check the official Releases page and same-version issues, verify with one later stable build, and test one version at a time while recording Running Mode.
- If service mode is now healthy and only TUN traffic fails, stop reinstalling and move to the route and DNS checks on the TUN page.
Case 4 — service or core errors appear only after an upgrade
Service binaries and core files change between releases. Check the official Releases page for the current stable version and known issues before deciding to upgrade or roll back, and do not overwrite-install across several versions in a row.
- Export the configuration you need beforehand, and keep the subscription URL in a separate, private place rather than in a public log.
- Test one version at a time and record the install result plus Running Mode after each attempt.
- An issue report proves that a specific environment produced a specific error; it does not mean every user should pin the same old build.
When the Releases page was checked on 2026-10-28 it showed v2.5.8 with a date of 2026-10-09. Versions keep moving, so re-check the official page before acting on this paragraph.
When to stop retrying
If you have saved the full version, Running Mode, Is Admin value and verbatim error, and the same operation still reproduces the failure, stop. Do not keep editing ACLs, deleting system services or running scripts from strangers. Search the official issues with the identical version and identical error string; on a managed device, contact the administrator. This stopping rule is risk control, not a repair effect verified in any issue.
What this page cannot promise
Official issues and discussions are evidence of a problem, not a blanket repair commitment across Windows versions. This page has not been tested on every antivirus product, managed device or legacy Windows build, and it will not recommend modifying unknown ACLs, deleting system services or running unfamiliar scripts. If an error names a specific path, redact the user name, device name and subscription details before sharing it.
Sources and verification date
Material checked 2026-10-28. Primary sources:
- Clash Verge Rev official Releases — current release and version notes.
- Official discussion #7475 — using System Info to read Is Admin and Service mode.
- Official issue #8138 — reproduction record for
program not foundduring service install. - Official issue #8023 — individual case of installer and service/core state not matching.
This article was assembled with AI assistance and edited against a verifiable-evidence boundary; issue comments were not rewritten into an official universal fix.
Frequently asked questions
Why does enabling TUN keep prompting me to install the service?
Look at Running Mode in System Info first. If it still says User, the client is not running in service mode; then check Is Admin, the full version number and the verbatim install error. TUN needs the service, so the prompt is the symptom, not the cause.
If Is Admin is true, will the service install succeed?
Not necessarily. Is Admin: true only confirms that the diagnostics report an elevated session. It does not guarantee the install succeeds and does not rule out every permission problem; search the issues with the identical error and version.
Should I download a separate service file when I see program not found?
Not from an unknown source. Use the official complete installer only. The error string does not by itself prove that a particular file is missing, so check Is Admin, Running Mode, version and the full error text before assuming anything.
Does issue #8023 apply to every version?
No. That issue records Windows 10 with v2.5.4 and v2.5.5 and one specific error string. A different version, error or log means the cause described there cannot simply be transferred.
The service installed but TUN still has no internet. What now?
Confirm in System Info that Running Mode is already Service. Only when service mode is healthy and connectivity still fails with TUN enabled should you move to the TUN page and check the virtual adapter, routes and DNS. Those are investigation directions, not causes you can confirm from the symptom alone.
Can I paste the complete log into a public issue?
Redact it first. Remove the subscription URL, tokens, node passwords, user name, device name, internal addresses and identifiable paths, keeping only the version, timestamps and the necessary error lines.
Continue reading
no internet after enabling TUN · core IPC pipe did not become ready within 15s · cannot select profile: socket error · the full error-string index