Updated July 2026 · 6 min read
Update Clash Verge Rev safely
Updating the client is not hard. What goes wrong almost always comes down to three things: no backup beforehand, the program not fully closed during the install, and nobody checking the service and the custom rules afterwards.
Give yourself a way back first
Verge settings include WebDAV backup, and once it is configured a single click is the cheapest insurance you can buy. Without it, open the data folder and copy your profiles and any config you edited by hand onto another drive.
While you are at it, store the subscription links separately in a password manager or a note. After a reinstall the painful part is rarely the settings; it is the link you cannot find and have to fetch from the provider panel all over again.
Close the program completely before installing
Turn off TUN, then the system proxy, then quit from the tray. Installing over a running copy with TUN active leaves the installer unable to replace files that are in use, and you end up half updated, with the service and the interface on different versions.
The installer can go straight over the old version; there is no need to uninstall first, and uninstalling may take your data with it. If the installer complains that a file is locked, something is still running — confirm in Task Manager and start over.
The core version and the client version are separate. An unsupported protocol calls for a core upgrade, a broken interface calls for a client upgrade, and mixing the two up wastes an evening.
The client and the core update separately
The client is the Tauri interface and the plumbing around it, and new builds come from the GitHub Release page. The mihomo core moves on its own schedule and is upgraded from settings. GeoIP and GeoSite data is a third thing again, tied to neither version.
Deciding which one you need is easy: a new protocol from your provider that refuses to connect, or a log line about an unknown field, means the core is too old. A frozen window or a switch that ignores clicks is the client.
Three things to re-check afterwards
First, is service mode still there? An in-place install sometimes leaves the service component out of step with the new build, and the symptom is TUN refusing to start; reinstalling the service from settings clears it. Second, actually switch TUN on rather than trusting the toggle.
Third, look at your custom rules, Merge and Script. The first subscription refresh after an update is exactly when a hand-edited profile gets overwritten. After a major version bump, keep the old installer and the backup for a couple of weeks, because a rollback depends on them.
What is the project?
Clash Verge Rev is a Tauri-based GUI for Mihomo with profile management, system proxy, TUN mode, rule editing and WebDAV backups.