Skip to main content
EN

Home / Blog / Features

Auto-launch, silent start and tray settings

Auto-launch, silent start and tray settings

Opening Clash Verge by hand after every boot, then turning the system proxy on by hand, gets old within two days. This covers everything related to starting automatically.

Three switches that get confused

Settings → General has three options people mix up:

What each one controls1Auto Launchrun Clash Verge when the system starts2Silent Startstart without showing the main window, straight to the tray3Auto enter lite moderelease the interface's memory after a period of inactivity, core keeps running
The first two work well together; the third is about memory

Auto Launch registers a startup entry with the system.

Silent Start only affects whether a window appears at launch. Without it, a window pops up every time you boot.

Lite mode: Clash Verge's interface is a WebView, which is where most of the memory goes. Lite mode unloads the interface and leaves the core running; click the tray icon and it comes back. Proxy behaviour is entirely unaffected.

Set it once and forget itAuto Launch — onSilent Start — onAuto enter lite mode — on (particularly useful if memory is tight)System proxy — on (this is remembered and restored after a reboot)Minimise to tray on close — on (so clicking X does not quit)

With that set, the experience is: boot the machine, do nothing, and the proxy is already working with an icon sitting quietly in the tray.

Platform specifics

Windows

Auto-launch is done through the registry, at:

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

About UAC: if Clash Verge is set to "run as administrator", the ordinary Windows startup mechanism cannot launch it (UAC blocks it). In that case use Task Scheduler instead:

  1. Win+R, then taskschd.msc
  2. Create Task → on the General tab tick "Run with highest privileges"
  3. Trigger: At log on
  4. Action: Start a program, pointing at the Clash Verge exe

Most people do not need this — Clash Verge does not require administrator rights by default, since the privileged parts of TUN are handled by the separately installed system service.

macOS

Auto-launch uses Login Items, visible under System Settings → General → Login Items.

Linux

Auto-start relies on your desktop environment's autostart mechanism, which produces a file here:

~/.config/autostart/clash-verge.desktop

Check whether it exists:

ls -l ~/.config/autostart/
cat ~/.config/autostart/clash-verge.desktop

If it is missing, toggle the setting in Clash Verge; if that still does not produce it, write it yourself:

[Desktop Entry]
Type=Application
Name=Clash Verge
Exec=/usr/bin/clash-verge
Icon=clash-verge
Terminal=false
X-GNOME-Autostart-enabled=true

GNOME, KDE, XFCE and Cinnamon all honour this standard location, with minor differences.

The tray icon

What the tray menu can do

Right-click the tray icon (single click on macOS) and you can usually:

  • Switch between rule, global and direct modes
  • Toggle the system proxy and TUN
  • Switch nodes quickly
  • Open the main window
  • Quit

For daily use this is much faster than opening the main window.

No tray icon under GNOME

GNOME removed legacy tray support in 3.26; you need an extension:

sudo apt install gnome-shell-extension-appindicator   # Debian/Ubuntu
sudo dnf install gnome-shell-extension-appindicator   # Fedora

Log out and back in, then confirm it is enabled in the Extensions app.

Windows hides the tray icon

Windows tucks less-used tray icons into the overflow area.

Settings → Personalisation → Taskbar → Other system tray icons → turn Clash Verge on and it stays visible.

Something easy to overlook: what happens when you quit

Quitting properly from the tray menu makes Clash Verge:

  1. Turn off the system proxy setting
  2. Remove the virtual adapter and routes, if TUN was on
  3. Stop the core process

Killing the process from Task Manager skips all three, which can leave a stale proxy setting behind — the classic "I closed the app and now nothing loads".

"It takes a while after boot before the internet works"

Some people notice the first 10–20 seconds after boot have no connectivity. Usually the sequence is:

Startup timingSystem bootsnetwork not ready yetClash Verge startsbegins loading configFetches subscription updatesif set to update at startupCore readyonly now is it usable
That subscription fetch slows everything down while the network is still settling

The fix: set a longer auto-update interval (24 hours) rather than relying on an update at every boot. The config is cached locally, so it can come up without network access.

In short

  • Auto Launch + Silent Start + lite mode is the least-effort combination
  • On Windows, when auto-launch fails, check Task Manager → Startup apps first
  • On macOS, re-set it after moving the app
  • Do not kill the process from Task Manager — quit from the tray

Related: six settings on first launch and uninstalling cleanly.